DECnet/E 


Guide to User Utilities 
Order No. AA-H504B-TC 


January 1982 


The DECnet/E utilities allow a terminal user to: talk to a user locally or at 
another node, log in at and use another DECnet/E node, manipulate files 
between nodes, and copy the contents of storage devices between DEC- 
net/E nodes. 


Operating System and Version: RSTS/E V7.1 
Software Version: DECnet/E V2.0 


‘| To order additional copies of this document, contact your local 
Digital Equipment Corporation Sales Office. 


digital equipment corporation - maynard, massachusetts 


First Printing, January 1982 


The information in this document is subject to change without notice and should not be construed as a 
commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this document. 


The software described in this document is furnished under a license and may only be used or copied in 
accordance with the terms of such license. 


No responsibility is assumed for the use or reliability of software on equipment that is not supplied by 
DIGITAL or its affiliated companies. 


Copyright © 1982 Digital Equipment Corporation 


The postage-prepaid READER’S COMMENTS form on the last page of this document requests the user’s 
critical evaluation to assist us in preparing future documentation. 


The following are trademarks of Digital Equipment Corporation: 


DIGITAL DECsystem-10 MASSBUS 
DEC DECtape OMNIBUS 
PDP DIBOL OS/8 
DECUS EDUSYSTEM PHA 
UNIBUS FLIP CHIP RSTS 
COMPUTER LABS ' FOCAL RSX 
COMTEX INDAC TYPESET-8 
DDT LAB-8 TYPESET-11 
DECCOMM..._.. DECSYSTEM-20 |. TMS-11 
ASSIST-11  ~ . _ RTS-8 eh ITPS-10 
VAX IAS SBI 
DECnet TRAX PDT 

' DATATRIEVE 


Distributed and Mid-Range Systems Publications typeset this manual using DIGITAL’s 
TMS-11 Text Management System. 


310ALL 


Contents 


Preface 


Chapter 1 Introduction 


1.1 Basic Terms and Concepts... .... 2. ee eee ee 
1.2 DECnet Networks... 2... 2 ee ee ee es 
1.3 The DIGITAL Network Architecture (DNA). .......- 
1.4 Network Routing. .. 2... 1. ee ee ee es 
1.5 Overview of DECnet/E Structure... .......4--. 


Chapter 2 TLK: Terminal Communication Utility 


91 One-line Mode. ..........--8 5582 22 4s 


2.1.1 Initiator’s Input .. 2... 1. 6 ee ee es 
2.1.2 Receiver’s Output... 2... ee es 


2.2 Dialog Mode... .. 1... 2-2 eee ee ee es 


2.2.1 Initiator’s Input .... 2... ee ee ee es 
9.9.2 Receiver’s Interaction. ........-0-50 886s 


2.3 TLK Error Messages... ..-- 2-2 ee ee ee tees 


Chapter 3 NET: Network Command Terminal Utility 


3.1 Running NET... . 2... ee es 
32 NET Commands. ........--.++5 858888 45% 


3.2.1 CONTINUE Command............+.--. 
3.2.2 CTRL/P Command..........++++-: 
3.2.3 EXIT Command..........-2 +++ 
3.2.4 HELP Command..........-++++-+65 
3.2.5 NORMAL Command........---+++++5 
3.2.6 ODT Command ..........++++265 


3.3 NET Error Messages. ...-. 2-0 ee tte te es 


Page 


vii 


iii 


Chapter 4 NFT: Network File Transfer Utility 


iv 


Al. Backsround 22. dre a iota ateaidtes: b bee he a BG Bw Ok wee Aes 4-3 
42° Reming NIU ihe a decige ies ie ke de we oak oD Boe eS he wo gece A hs 4-4 
4.3 General Format of NFT Commands. .........2..2....... 4-5 
4.3.1 Node Names. ..........0..00 00.000 ee eee ee 4-5 
4.3.2 File Specifications ... 2... .....0.0.0.0. 000-0048 4-7 
ASi3) Wildcards: 3. 4. cis ee haiisn Soh vy eects ARS eS ae ERE Ge 4-8 
4.3.4 Quoted Strings... ........0...0.0.0. 00000084 4-9 
44 NFT Commands. .................2. 00002 eae 4-10 
4.4.1 APPEND Command ....................0.4 4-11 
4.4.2 COPY Command...................2.004 4-13 
44.3 DELETE Command ...............0....... 4-15 
4.4.4 DIRECTORY Command ..................4 4-16 
4.4.5 EXITCommand....................... 4-18 
4.4.6 HELPCommand..............0...00. 2.004 4-19 
4.4.1 NODESPECIFICATION Command.............. 4-20 
44.8: PRINT Command: -¢ ese a ew @ eG ee 4-22 
4.4.9 SUBMIT Command ....................4. 4-24 
4.4.10 TYPE Command...................000.4 4-26 
4.4.11 VERSION Command...................0.., 4-27 
BiB: INE LO WILCHOR "5 <2 Gis fed 28's Bina, asc & Sugg Blew age des Boe 4-28 
4.5.1 /APPEND — Append Input to Output... ......202.2.. 4-29 
4.5.2 /ASCII — Transfer 7-Bit ASCII Data. .........2.., 4-29 
4.5.3 /BLOCK — Transfer Image Data in 512-Byte Blocks. ..... 4-29 
4.5.4 /BRIEF — Output a Brief DIRECTORY Listing. ....... 4-30 
4.5.5 /CONTIGUOUS or /CTG — Allocate Space Contiguously. | . . 4-30 
4.5.6 /DELETE — Delete Files on Close .........2.2.... 4-30 
4.5.7 /FULL — Output a Full DIRECTORY Listing. .......~. 4-31 
4.5.8 /IDENTIFY — Prompt for Log-in Information. ........ 4-31 
4.5.9 /IMAGE — Transfer 8-Bit Image Data... .....2..... 4-32 
4.5.10 /INQUIRY — Prompt for Input File Verification. ....... 4-32 
4.5.11 /LIST — Output a Normal DIRECTORY Listing. ....... 4-32 
4.5.12 /LOG — Log Input File Name on Close... ......2.. 4-33 
4.5.13 /MORE — Continue Command to Next Line... ....... 4-33 
4.5.14 /NATIVE — Reformat File to Stream ASCII... ....... 4-33 
4.5.15 /NOCONTIGUOUS — Allocate Space Noncontiguously. . .. . 4-34 
4.5.16 /NODELETE — Save Temporary Files ............ 4-34 
4.5.17 /NOHEADING — Output a DIRECTORY Listing with No Header 4-35 
4.5.18 /NOSUPERSEDE — Do Not Supersede an Existing File. . . . 4-35 
4.5.19 /POS — Position to End of Volume .............. 4-35 
4.5.20 /RWC — Rewind File on Close ................ 4-36 
4.5.21 /RWO — Rewind Fileon Open ................ 4-36 
4.5.22 /SUPERSEDE — Supersede an Existing File... ....... 4-36 
4.5.23 /TOTAL — Output Directory Size Only. .......2.2..~. 4-36 
4.5.24 /VARIABLE — Reformat File to Variable Format ...... . 4-36 
4.6 NFT Error Messages... ........2.2..0.000 004 ee eee 4-37 


Chapter 5 NETCPY: Network Copy between Devices 


5.4 


Running NETCPY. . 2. 6 2 ee 
General Form of NETCPY Command. ....... +--+ see se 
NETCPY Option Switches. . 2. 6 6 ee ee es 


5.3.1 /BLOCK:b — Block Size Switch... 2... - ee ee eee 
5.3.2 /DENSITY:d — Set Density Switch. .. 2... -/ ee ees 
5.3.3 /FC — Fast Copy Switch. . 2... 6 ee ee es 
5.3.4 /HELP — Help Switch... . 1... 2 eee ee eee 
5.3.5 /NC — No Copy Switch... 2... 2... eee ee ee 
5.3.6 /PARITY:p — Set Parity Switch .. 2-2... - eee ees 
5.3.7 /VERIFY — Verify Switch . 2... 2 ee ee es 


NETCPY Error Messages .. . - - ) 0 et t t e  t 


Chapter 6 NETOFF: Network Shutdown 


Appendix A Object Type Codes 


Appendix B NSP Reason Codes for Connect Reject and Link Abort 


Appendix C NETACT: Automatic Log-in Utility for NFT 


Appendix D Error Messages Generated by RMS and DAP 


Index 


Figures 


DECnet/E Features for the Terminal User... . - 2-7 7 ee ees 
Computer Network Composed of Five Nodes .....-- +--+ +--+ 
The TLK Utility: TLK and LSN Provide Communication 

between Terminals. . 2... 0. ee ee 
NET Provides Access to Another DECnet/E Node. ......---:5 
NFT Transfers Files to, from, and between Remote Nodes. .....-. - 
At DECnet/E Nodes, NFT, FAL, and RMS Work Together 

to Allow File Operations. . 2. 6 6 ee ee 
Sample Network Showing Transfers between Nodes 

with DECnet/E NFT. 2. 2 0 we 


4-4 
4-5 
4-6 
4-7 
4-8 
4-9 
4-10 
5-1 


Example of the APPEND Command ................. 4-12 


Examples of the COPY Command .................., 4-14 
Example of the DELETE Command ................. 4-15 
Example of the DIRECTORY Command ............... 4-17 
Example of the PRINT Command .................. 4-23 
Example of the SUBMIT Command ................. 4-25 
Example of the TYPE Command. .................. 4-26 


NETCPY Copies an Entire Device from One DECnet/E Node 
to Another DECnet/E Node .................0-044 5-1 


Preface 


Manual Objectives 


DECnet/E is a combination of hardware and software that extends the capa- 
bilities of a RSTS/E system on a DIGITAL PDP-11 computer to allow com- 
munication with other DECnet systems in a network. This manual 
describes the DECnet/E utilities that allow a terminal user to talk to a user 
locally or at another node, log in at and use another DECnet/E node, manip- 
ulate files between nodes, and copy the contents of entire disks and tapes 
between devices at different DECnet/E nodes. 


Intended Audience 


This manual is written for the nontechnical RSTS/E terminal user who 
wishes to use the DECnet/E facilities to access remote systems within his 
network. The reader is expected to have a basic understanding of the oper- 
ation of the local RSTS/E system, as well as that of the remote system being 
accessed, but is not expected to be a sophisticated computer user or 
programmer. 


Related Documents 


The terminal user who wishes to use the DECnet/E utilities will find all the 
information necessary to do so in this manual. To obtain a general under- 
standing of the DECnet environment, however, the reader is directed to the 
following manual: 


Introduction to DECnet, Order No. AA-J0O55B-TK 


DECnet/E also provides message services that allow a programmer to 
develop programs that exchange data with programs running on other DEC- 
net systems in a network. These features are described in four companion 
manuals: 


DECnet/E Network Programming in BASIC-PLUS and 
BASIC—PLUS-2, Order No. AA-H501B-TC 

DECnet/E Network Programming in MACRO-11, 
Order No. AA-L265A-TC 

DECnet/E Network Programming in FORTRAN, 

Order No. AA-L266A-TC 

DECnet/E Network Programming in COBOL, 

Order No. AA-H503B-TC 


Two other companion manuals tell how to generate and start a DECnet/E 
system, control and monitor a running DECnet/E system, and give other 
information useful to a system manager. 


DECnet/E Network Installation Guide, Order No. AA-K714A-TC 
DECnet/E System Manager’s Guide, Order No. AA-H505B-TC 


vii 


viii 


Structure of This Manual 


This manual is structured as a reference guide. It is divided into chapters, 
one for each available network utility. The function and capabilities of each 
utility are described and step-by-step instructions are presented for their 


use. 


Documentation Conventions 


Throughout this manual, the following documentation conventions are used 


to describe keyboard input: 
UPERCASE 


lowercase 


[ ] 


{ } 


red/black 


CTRL/ 


Uppercase letters indicate keywords that must 
be entered as shown. 


Lowercase italic letters represent items that 
must be replaced according to the accom- 
panying description. When an item requires.a 
descriptor or more than one word, the descrip- 
tor is hyphenated. For example, file- 
specification. 


Square brackets enclose an optional field that 
need not be included. In general, brackets are 
logical symbols only and should not be included 
in the input. Brackets surrounding a project- 
programmer number, however, must be 
included. 


Braces indicate a choice of input items, one of 
which must be specified. 


User input is shown in red. Program output 
(prompts and displays) is shown in black. 


The character string “CTRL” followed by a let- 
ter indicates a control character (for example, 
CTRL/Z). Control characters are generated by 
depressing the CTRL key and the appropriate 
letter key at the same time and are echoed on 
the console display as a caret (*) followed by the 
letter (for example, “Z). 


Unless shown otherwise, spaces or tabs must separate items in a command 
string. More than one space or tab between items is treated by the system as 
a single space. Also, although it is not shown in this manual, you must fol- 
low the last item of input in a command string with a carriage return. 


Chapter 1 
Introduction 


This manual tells how to use DECnet/E utilities to perform the following 
operations: 


1. 


Communicate with someone at a terminal on another DECnet system 
that has a compatible receiver utility. Each person can type messages 
that will be displayed at the other’s terminal (see TLK, Chapter 2). 


. Do work on another DECnet/E system as if your terminal were con- 


nected directly to the other system (see NET, Chapter 3). 


. Copy files to or from other DECnet systems, submit command files to 


other systems, and delete files at other systems (see NFT, Chapter 4). 


. Copy the contents of an entire storage device to or from another 


DECnet/E system (see NETCPY, Chapter 5). 


. Shut down the network in an orderly fashion (see NETOFF, Chapter 


6). 


OO 


DECnet/E 
SYSTEM 


TLK> MURRAY — MOUNT A TAPE 


>NFT DENVER: FILE=MYFILE 


LOG INTO AND TALK TO MANIPULATE 
USE ANOTHER REMOTE USERS NETWORK FILES 
DECnet/E SYSTEM COPY DEVICES 


Figure 1-1 DECnet/E Features for the Terminal User 


1.1 Basic Terms and Concepts 
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The term network is used here to refer to two or more computer systems con- 
nected so that they can exchange information. The computer systems, called 
nodes, are connected by communications paths called physical links. Phys- 
ical links can be established through normal (switched) telephone circuits, 
several varieties of leased (private) lines, coaxial cables, or even satellite 
transmission facilities provided by several carriers. 


In the network shown in Figure 1-2, a user at node BOSTON would refer to 
BOSTON as the local node and to nodes DENVER, DALLAS, LONDON, 
and LA as remote nodes. At node BOSTON, the nodes DENVER, DALLAS 
and LONDON are physically adjacent nodes. That is, there is a direct phys- 
ical link to these nodes with no intervening nodes. To a user at node LA, 
DENVER is the only adjacent node. 


A path is the route over which data travels from its source to its destination 
within the network. Path length is the distance from the source node to the 
destination node, measured in hops. A hop is equal to a physical line 
between two adjacent nodes. In Figure 1-2, the path length between nodes 
DALLAS and BOSTON is one hop and between LA and LONDON is three 
hops. The network diameter is the maximum path length between any two 
nodes. The network shown in Figure 1-2 has a network diameter of three 
hops. 


The utilities described in this manual establish logical links to communicate 
with their counterparts at remote nodes. A logical link is a software path for 
the exchange of data between two programs running in a network. DEC- 
net/E Version 2.0 is a Phase II] DECnet product. (Refer to Introduction to 
DECnet for a discussion of the differences between Phase II and Phase III 
DECnet products.) As such, it supports the adaptive routing feature of 
Phase III, providing the user with the capability of communicating with 
other Phase ITI nodes in the network, regardless of whether or not they are 
directly connected to the local node. 
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1-1. BASIC 


Figure 1-2 Computer Network Composed of Five Nodes. 


1.2 DECnet Networks 


DECnet as a whole refers to the hardware and software that allows different 
DIGITAL systems to be connected to form networks. DECnet has been 
designed to allow each system to function as a separate entity but still allow 
access to resources that are distributed throughout the various computer 
systems in the network. A DECnet/E system provides all the capabilities of 
a normal RSTS/E system plus the networking capabilities described here 
and in the companion DECnet/E manuals listed in the Preface. 


All DECnet implementations are based on a design structure called the 
DIGITAL Network Architecture (DNA). This architecture allows network 
implementations on the various DIGITAL systems to evolve (to provide 
more and more capability as time goes on) within a basic common structure. 
The structure ensures that implementations providing fewer features will 
always work with implementations providing more. 


Perhaps a more immediate aspect of this process of evolution, however, is 
that at any given time capabilities can indeed differ from system to system. 
The DECnet implementations for all the different DIGITAL systems are not 
described here. Nevertheless, to use the DECnet/E utilities, you do need to 
give some thought to other DIGITAL systems in your network. 
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If your network consists entirely of DECnet/E Version 2.0 nodes, this docu- 
ment provides all the information you need to use the DECnet/E utilities. If 
your network contains other DECnet systems, however, you will need to 
check the DECnet documentation for the other systems to be sure that the 
corresponding capabilities exist. 


The DECnet/E utilities TLK and NFT are designed and implemented 
according to the protocols defined as part of the DIGITAL Network Archi- 
tecture. You can use them with non-DECnet/E systems as long as the corre- 
sponding feature is implemented in that system. The DECnet/E utilities 
NET and NETCPY, on the other hand, are networking features unique to 
DECnet/E and will work only with other DECnet/E systems. 


A brief overview of the functional capabilities of the various DECnet imple- 
mentations can be found in Introduction to DECnet. 


1.3. The DIGITAL Network Architecture (DNA) 
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DECnet/E is implemented according to a set of rules, or protocols, governing 
the format, control, and sequencing of data exchange from the user program 
level down through the physical link level. These protocols are defined by 
the DIGITAL Network Architecture (DNA) — a logical structure that pro- 
vides the model for all DECnet implementations. 


DNA consists of several layers, each defining a distinct set of network func- 
tions and a set of rules for implementing those functions. Each DECnet 
implementation consists of software modules that perform these DNA- 
defined functions according to DNA-defined protocols. 


At the lowest layer, physical link control is achieved in DECnet by imple- 
mentation of the Digital Data Communications Message Protocol (DDCMP). 
DDCMP ensures an error-free, sequential data path over a generally error- 
prone medium. This is accomplished with the Cyclic Redundancy Check 
(CRC) for error detection, retransmission for error corrections, and num- 
bered data segments to ensure sequential transmission of data. 


The Network Services Protocol (NSP) defines the rules for communication 
between programs in a network over paths called logical links. Logical links 
are described in detail in the network programming manuals for the various 
DECnet/E language interfaces, as named in the Preface. Briefly, logical 
links allow many different data streams to be multiplexed for transmission 
over the physical link and separated at the receiving node for delivery to the 
appropriate program. The utilities described in this manual communicate 
using logical links. 


The Transport protocol defines the rules for determining the actual physical 
path, or route, along which data travels to its destination. 


The Data Access Protocol (DAP) defines conventions for DECnet utilities 
that transfer and manipulate files. This protocol includes a specific language 
that these utilities use to transfer commands and data. The NFT and FAL 
utilities described in this manual communicate according to the DAP 
protocol. 
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1.4 Network Routing 


DECnet/E Version 2.0 is a Phase III DECnet product. (Refer to Introduction 
to DECnet for a discussion of the differences between Phase II and Phase III 
DECnet products.) As such, it supports the adaptive routing feature of 
Phase III, providing the user with the capability of communicating with 
other nodes in the network regardless of whether or not they are dicey: 
connected to the local node. 


Networks can consist of the following three types of nodes: 


e Routing nodes — Phase III nodes connected to multiple communications 
lines, supporting route-through capabilities. 


e Nonrouting nodes (end nodes) — Phase III nodes connected to a single 
communications line. 


@ Phase Ill nodes — nodes running a previous generation of the DECnet 
architecture. 


Phase III nodes can communicate with and are compatible with Phase II 
nodes. However, Phase II nodes do not acquire any new capabilities by being 
connected to Phase III nodes, and the restriction that Phase II nodes can 
only communicate with adjacent nodes continues to apply. Thus, a Phase III 
node can communicate with any other Phase III node, providing the path 
goes through Phase III nodes only. 


The adaptive routing feature is implemented through an algorithm that 
chooses the routing path with the lowest associated cost. Cost is computed as 
the sum of the costs of the lines over which the message is transmitted. The 
individual line cost parameters are assigned by the system manager and 
input into the system using the Network Control Program (NCP). (See the 
DECnet/E System Manager’s Guide for a full discussion of line costs.) The 
algorithm automatically adjusts the routing when network topology or line 
cost changes occur. 


1.5 Overview of DECnet/E Structure 


You do not really need to know how DECnet/E is implemented to use the 
utilities described in this manual. It is probably useful, however, to have 
some appreciation for how the utilities themselves fit into the overall DEC- 
net design and implementation. 


As mentioned before, the utilities described in this manual communicate 
over the network using logical links. The DECnet/E implementation of the 
Network Services Protocol, that provides the capability for establishing log- 
ical links, is a part of the RSTS/E monitor. Although it is not a separate 
entity or program in DECnet/E, the term NSP is used in this manual and 
the companion DECnet/E manuals to refer to the software that allows a user 
program to establish and exchange data over logical links. In other words, 
NSP is the implementation of the Network Services Protocol. 
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NSP, the utilities described in this manual, and NCP, the Network Control 
Program (described in the DECnet/E System Manager’s Guide), are visible 
to the user. To code a program that exchanges information with another pro- 
gram, a programmer uses calls that NSP executes. A terminal user runs 
TLK, NFT, NETCPY, and NET to use their services. The system manager 
runs NCP to start, monitor and control the local node and other nodes in the 
network. 


Some elements of DECnet/E, however, are not directly accessible to any 
user. These lower level elements of DECnet/E include the Transport module 
(TRN), that implements the Transport protocol, several hardware devices 
(the DMC11, DMR11, DMV11, and DMP11) and their associated software 
device drivers. 


The device drivers are responsible for handling messages received from and 
sent over the physical communication lines. NSP gives an outgoing message 
to Transport, and Transport selects an appropriate data path based on the 
destination of the message. Transport then passes the message to the proper 
device driver for actual transmission. The drivers manipulate the device 
registers to cause message transmission to occur. 


To handle incoming messages, the drivers include buffer management func- 
tions that allow messages to be received from the physical links. When a 
message is received, it is passed to Transport, and Transport checks the des- 
tination of the message. If the message is for the local node, Transport 
passes it to NSP for further processing. If the message is destined for 
another node in the network, Transport selects a data path and passes the 
message to one of the drivers for transmission. 


The hardware devices are intelligent communication controllers that con- 
nect the PDP-11 to physical communication lines. The DMC11 and the 
DMR11 control lines that connect to only one other system in the network 
(point-to-point lines) while the DMV11 and the DMP11 control lines that 
can connect to more than one other system (multipoint lines). The physical 
lines can include cables, modems and telephone circuits, or even satellite 
transmission facilities. Each controller contains a microprocessor, its own 
memory, and microcode that implements the DDCMP protocol. The imple- 
mentation of DDCMP in firmware considerably reduces the software over- 
head for the DECnet/E system. 
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Chapter 2 
TLK: Terminal Communication Utility 


The TLK utility lets you send messages to another person at any other ter- 
minal in the network, including the Operator Services Console (OSC), pro- 
vided that the system to which the remote terminal is connected has a 
utility designed to receive such messages. Two communication modes are 
available. 


1. One-line mode allows transmission of a one-line message to another 
terminal. 


2. Dialog mode allows two-way communication between two terminals. 
The dialog can be stopped at any time by the person at either 
terminal. 


The TLK utility is implemented as two programs in the RSTS/E environ- 
ment: TLK (Talk) and LSN (Listen). Figure 2-1 shows a sample conversa- 
tion in dialog mode, and also illustrates the general relationship of TLK and 
LSN. TLK is executed at a RSTS/E node at the direct request of one of the 
local terminal users. LSN is executed to complete a connection requested by 
a TLK program. 


<TLK> in Dialogue with WEST::KB2: 
2 

HELLO, EAST COAST! 

>: 


DID YOU GET THE TAPES YET? 
>YES! GOT THEM YESTERDAY 


> 
GREAT. BYE FOR NOW. 
<TLK> End of Dialogue 


RUN $TLK 
EAST::KB41: 

>HELLO, EAST COAST! 

>DID YOU GET THE TAPES YET? 


> 

YES! GOT THEM YESTERDAY. 
>GREAT. BYE FOR NOW. 
>AZ 

<TLK> End of Dialogue 


Figure 2-1: The TLK Utility: TLK and LSN Provide Communication 
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2.1 One-line Mode 


Using the TLK utility in one-line mode, you can transmit one line of infor- 
mation to another terminal. The following subsections describe the input 
required to initiate a message and the output displayed at the receiver’s 
terminal. 


2.1.1. Initiator’s Input 


To send a one-line message to another terminal, type: 


RUN $TLK 
TLK V2.0 RSTS V7.1 Timesharing NSP 
*[target-node::|[target-terminal:] ’message 


ONE-LINE MODE: 
MESSAGE, PRECEDED BY A 


SINGLE QUOTE, ON SAME LINE 
AS TARGET INFORMATION 


If TLK has been installed as a Concise Command Language (CCL) com- 
mand, you can also type 


TLK [target-node::][target-terminal:] ’message 
In either case, the length of a line cannot exceed 132 characters. 


The target-node is the 1- to 6-character ASCII node name to which the mes- 
sage is to be sent. If the local node is the target, the node name can be 
omitted. If a node name is given, the two colons (::) must be used. (The 
names of nodes that are currently active on the network can be determined 
with the NCP command, SHOW ACTIVE NODES. See the DECnet/E 
System Manager’s Guide.) 


The target-terminal is the device designation of the terminal to which the 
message is to be sent (for example, TT5: or KB41:). If the operator’s console 
is the target, the target terminal can be omitted. TLK will then automati- 
cally send the message to the operator’s console at the node specified. (Under 
the RSTS/E system, for example, the operator’s service console can be 
assigned to different physical devices at different times for the operator’s 
convenience. By not specifying a specific device, such as KBO:, you ensure 
that the message reaches the current operator’s console device.) 


If the node specified is the local node, TLK will check to make sure the tar- 
get terminal specified is a terminal known to the system. The usual designa- 
tion for terminals under the RSTS/E system is KBn: or TTn:, where n is the 
physical terminal number. However, logical names established with an 
ASSIGN command can also be used for target terminals at the local node. 
(See the RSTS/E System User’s Guide for a discussion of logical device 
names.) 
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If the node specified is a remote node, TLK extracts only the decimal termi- 
nal number from the target terminal specification and forwards that num- 
ber to the TLK (or LSN) program at the remote node. The remote node’s 
TLK (or LSN) utility will return an error if the device number is invalid for 
that node. 


The message is any ASCII string; it is the message to be transmitted. The 
message must be preceded by a single quote and cannot extend beyond the 
end of the current line. Leading and trailing blanks and tabs will be deleted. 
(The entire line cannot exceed 132 characters.) 


Example: 


The following example shows a one-line message sent from the local node 
(known as MAYNRD on the network) to terminal KB5: at a remote node 
called SANFRN. 


RUN $TLK 
TLK V2.0 RSTS V7.1 Timesharing NSP 
SSANFRNe SKBS: ‘Relay my calls to (617) 123-4367, Sheldon, 


The following example shows a one-line message sent to the operator’s serv- 
ice console at the local node: 


TLK ‘MOUNT TAPE MMO15 ON UNIT MMI: 


2.1.2 Receiver’s Output 


A one-line message targeted to a RSTS/E terminal is displayed as follows: 
<TLK> source-node:: source-terminal: message 


The source-node is the name of the node where the message originated. It is 
omitted if the message came from the local node. The source-terminal is the 
device designation of the terminal from which the message originated. The 
message is the ASCII message. 


The LSN program at the RSTS/E node sends the message to the designated 
terminal. If the terminal is busy, the executing program is not halted but 
the message is displayed regardless of whatever else may be going on. That 
is, the line can be displayed with other text being displayed at the terminal. 


A message arriving for the local node’s operator services console when 
OPSER (the operator services program) is running is displayed in the usual 
OPSER format: 


MESSAGE nnnnn:date time JOB:nn jobnamelppn] 
<TLK> source-node:: source-terminal: 
*message 


If OPSER was not installed as part of the RSTS/E system, or if for some rea- 
son it is not running, the message will be broadcast to KBO: in the ordinary 
format. 
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(OPSER provides various capabilities useful to a computer operator or sys- 
tem manager. The program is described in detail in the RSTS/E System 
Manager's Guide.) 


Example: 


Assuming that the first one-line message in the previous example arrived at 
a RSTS/E node, the message would appear as follows: 


<TLK> MAYNRD:: KB4: ‘Relay my calls to (G17)123-4567,. Sheldon, 


If OPSER is running, the second one-line example would appear at the local 
node as follows: 


MESSAGE 23402 : 19-Mar-82 12:45 PM JOB:13 TLKE1225100] 
<TLK> MAYNRD:: KB4: 
‘MOUNT TAPE MMO15 ON MMI: 


2.2 Dialog Mode 


Using the TLK utility in dialog mode, you can enter into an exchange with a 
user at another terminal. The following subsections describe the input 
required to initiate such a dialog, as well as the output displayed at the 
receiver's terminal and the input required from the receiver to continue the 
conversation. 


2.2.1 Initiator’s Input 


To initiate a dialog with a person at another terminal, type the following: 


RUN $TLK 

TLK V2.0 RSTS V7.1 Timesharing NSP 
*(target-node::|[target-terminal:] 
>message 


DIALOG MODE: FIRST 
MESSAGE ON LINE AFTER 


TARGET INFORMATION, NO 
SINGLE-QUOTE NEEDED 


If TLK has been installed as a Concise Command Language (CCL) com- 
mand, you can also type the following: 


TLK [target-node::|[target-terminal:] 
>message 


The target-node, target-terminal, and message input parameters are the 
same as for one-line mode except that the message does not require the pre- 
ceding single quote. 
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Wait for the > prompt from TLK before typing the first line of the message. 
TLK will continue prompting for new lines with this character. Returned 
messages from the receiver end of the dialog will be displayed as lines inter- 
spersed with the initiator’s lines (see the example that follows) until one or 
the other types a CTRL/Z in response to a > prompt. 


Example: 


The following example shows a typical dialog and how the conversation pro- 
ceeds from the initiator’s end. 


TLK MAYNRD:: KB4: 

+Sheldon--a call came long-distance: couldn‘’t be transferred, 
> 

Oh. Who was its did they leave a number to call back? 
»Yes--Gladys Freen of Ferns Ferns Freens and Fern, Call 
»(415)987-6549 after 10:00 (1:00 pm vour time), 

> 

OK--thanks again. Sheldon. 

<TLK? End of Dialog 


Ready 


(The dialog was terminated by the receiver in this example.) 


2.2.2 Receiver’s Interaction 


If the target terminal is not busy (no one is logged in), the RSTS/E LSN pro- 
gram displays the first line of a dialog-mode message as follows: 


<TLK> in Dialog with source-node:: source-terminal: 
> 
message-1 


You can then continue the dialog by typing a return line in response to a > 
prompt. 


If the receiving terminal is busy (someone is logged in at the terminal), the 
following display is made: 


<TLK> in Dialog with source-node:: source-terminal: 
Type ‘TLK/n source-node:: source-terminal: to continue dialog 


The material in single quotes is what should be typed to continue the dialog. 
For example, TLK/6 NOD5::KB12:. LSN will then wait up to two minutes 
for the dialog to be continued. You can stop what you are doing at the termi- 
nal and type the indicated command to continue the dialog, or you can go to 
another terminal, log in, and type the indicated command to continue the 
dialog. The number 7 following the slash is the job number of the copy of the 
local LSN that is waiting for the response to continue the dialog. At least 
one space must be typed after the job number. 


You actually run TLK when you type the command for continuing the dia- 
log. TLK tells the waiting LSN utiltiy that the dialog will continue and 
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identifies the terminal from which it will continue. TLK then detaches from 
the terminal so that LSN can control the interactive dialog. TLK and LSN 
are separate jobs in this case. Both are terminated when the dialog is 
stopped by either user. When the dialog is complete, LSN kills itself and 
TLK reattaches to the terminal and exits. 


You can also choose to continue the dialog with the RUN $TLK speci- 
fication: 


RUN $TLK 
TLK V2.0 RSTS V7.1 Timesharing NSP 
*/6 NOD5::KB12: 


Once the line is typed, the first message is displayed and the dialog contin- 
ues in the usual manner until either person types a CTRL/Z in response to a 
> prompt. LSN then breaks the connection and displays the following 
message: 


<TLK> End of Dialog 


If the receiving terminal is the local operator services console and the 
OPSER routine is running, the display for a busy terminal is made in the 
standard OPSER format: 


MESSAGE nnnnn:date time JOB:nn jobname-ppn/] 
<TLK> in Dialog with source-node:: source-terminal: 
Type ‘TLK/n source-node:: source-terminal: to continue dialog 


Operation will then proceed as for a busy terminal. 
Example: 


The following example illustrates how the conversation from the previous 
example might have looked from the receiver’s end. (The user is logged in, 
entering text with an editing program.) 


+ 


+ 


*#I1/And so» after/ 
{TLK? in Dialog with SANFRNs:: KBS: 
Type ‘TLK/13 SANFRN:: KBS:’ to continue dialog 


#exit \ 
\ 
\ (user exits from the editor 
/ 


; and starts TLK) 


Ready / 
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TLK/13 SANFRN::KBS: 

> 

Sheldon--a call came long-distances couldn’t be transferred, 
‘Oh. Who was its did they leave a number to call back? 

> 

Yes--Gladys Freen of Ferns Ferns Freens and Fern, Call 

> 

(415)987-6543 after 10:00 (1:00 Pm your time), 

2OK--thanks again. Sheldon- 


SC TRL/ 
£TLK> End of Dialog 


2.3 TLK Error Messages 


Command syntax error — Illegal job number — /n 


The job number you typed to continue a dialog is not a valid RSTS/E job 
number. Check the display that TLK printed and retype the line to con- 
tinue the dialog. 

Command syntax error — Illegal message 


This error occurs if you try to type a message on the same line as the exe- 
cute line for continuing a dialog. Retype the command line. When TLK 
prints the > prompt, you can then type the message you want sent. 
Command syntax error — Illegal node name — nodename 
The node name specified in a command line is not recognized by TLK. 
Retype the line with the correct node name. 
Command syntax error — Illegal terminal specification — spec 
The terminal specification shown (spec) is incorrect. Retype the com- 
mand line. 
Command syntax error — Job n is not a message receiver 


The job number typed to continue a dialog is a valid job number but the 
job is not a message receiver. Check the display that TLK printed and 
retype the line to continue the dialog. 


Command syntax error — Job n does not meet dialog requirements 


The job number typed to continue a dialog is a valid job number, and the 
job is a message receiver, but the job is not the same one that initiated 
the dialog. Check the display that TLK printed and retype the line to 
continue the dialog. 


Command syntax error — Message too long 


The maximum line that TLK will accept is 132 characters. Retype the 
message with shorter lines. 
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Connect Initiate error — text 


TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages, but it got an error on the initial connection request. 
The ¢ext is the error text TLK got in response to its attempt to send a 
Connect Initiate Message. (See DECnet/E Network Programming in 
BASIC-PLUS and BASIC—PLUS-2 for further description of the error 
text.) 


Connection rejected by NSP — Code:n 


TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote NSP. 
The code 7 is the reason code that the remote NSP returned in its rejec- 
tion. Appendix B lists the meanings for the various NSP error codes. 


Connection rejected by remote TLK — Code:n 


TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote TLK 
or LSN. The code n was returned in the rejection and its meaning 
depends on the remote TLK. Contact a DIGITAL Software Support rep- 
resentative if this error occurs repeatedly. 


Connection rejected by remote TLK — Illegal value in TLK mode byte 


TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote TLK 
or LSN. Contact a DIGITAL Software Support representative if this 
error occurs repeatedly. 


Connection rejected by remote TLK — Terminal is busy 


This error occurs when you have initiated a dialog and the remote termi- 
nal is busy, but no one has responded to continue the dialog. (The remote 
user is allowed two minutes to respond and continue the dialog; in this 
case, no one did.) 


Connection rejected by remote TLK — Terminal is nonexistent 


The remote terminal requested does not exist at the remote node. Check 
for possible error in the command line. 


Connection rejected by remote TLK — text 


The remote TLK or LSN could not accept the logical link connection that 
would allow the one-line or dialog exchange. The text is the error mes- 
sage that the remote TLK or LSN got in trying to issue its connect con- 
firmation. If this error occurs often, contact a DIGITAL Software 
Support representative. 
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Connection rejected by remote TLK — Unknown format 


The remote TLK did not recognize the parameters passed in the request 
to set up a logical link that would allow the one-line or dialog exchange. 
This could occur if the remote TLK is part of a Phase I implementation of 
DECnet — an earlier implementation than the local TLK/DECnet. Con- 
tact a DIGITAL Software Support representative. 


Declare Receiver error — text 


The local TLK could not begin to set up message exchange facilities at 
the local node. The text is the text of the error message received in its 
Declare Receiver system call. 


DECnet is not installed 
DECnet was not installed at system generation time. No network func- 
tions can be executed. 

Dialog already continued by job n, account[ppn], from KBn: 


You or someone else has already typed the line requesting a dialog con- 
tinuation. The account number and terminal number can be used to 
determine who continued the dialog and from which terminal. 


Disconnected by remote TLK — Code:n 


The logical link allowing the one-line or dialog exchange has been dis- 
connected by the remote TLK. The code n was returned by the remote 
TLK in its disconnection. Contact a DIGITAL Software Support repre- 
sentative if this error occurs repeatedly. 


Disconnected by remote TLK — Transfer error 


An error occurred at the remote site in transferring a message to or from 
the remote terminal. Contact a DIGITAL Software Support representa- 
tive if this error occurs often. 


Job n is not in dialog with specified target 
In continuing a dialog, you typed the wrong terminal or node name. 
Check the display that TLK printed and retype the command line. 

Link aborted by NSP — Code:n 


The logical link allowing the one-line or dialog exchange has been 
aborted. The coden is the reason code supplied by NSP in the Link Abort 
Message terminating the link. Appendix B lists the meanings for the 
various NSP error codes. 
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Link could not be established — Timeout 


Two minutes went by after the remote TLK printed its message for con- 
tinuing a dialog and no one responded. The dialog was timed out. 


Link could not be established — text 


The local TLK got an error in receiving a Connect Confirm Message from 
the remote TLK (or LSN). The logical link that would provide the one- 
line or dialog exchange could not be set up. The text is the NSP error 
message that the local TLK got on its Receive system call. Contact a 
DIGITAL Software Support representative. 


Message too long 


A line typed in dialog mode was longer than 132 characters. Retype the 
message using shorter lines. 


NSP is not enabled 


NSP, the part of DECnet that would allow the logical link connections 
providing the one-line or dialog exchange, has not been enabled at the 
local node. See the system manager. 


Receive error — text 


The local TLK (or LSN) got an error in receiving a message from the 
remote end. The fext is the error message returned on the Receive system 
call. Contact a DIGITAL Software Support representative. 


Send data error — text 


The local TLK (or LSN) got an error in sending a message to the remote 
end. The text is the error message returned on the Send Network Data 
Message system call. Refer to DECnet/E Network Programming in 
BASIC-PLUS and BASIC-PLUS-2 for further details of the error text, 
and contact a DIGITAL Software Support representative. 
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Chapter 3 
NET: Network Command Terminal Utility 


The NET utility lets you access another DECnet/E system in the network 
and do work there as if your terminal were directly connected to the other 
system. 


RUN $NET 
Node Name? BOSTON::HELLO 
#2/218 

Password? (not echoed) 
Ready 


Figure 3-1 NET Provides Access to Another DECnet/E Node 


NET is implemented as two programs: NET and NPKDVR. Figure 3-1 
shows a user running NET at node DENVER. NET requests a logical link 
with NPKDVR at the remote node BOSTON. NPKDVR opens a pseudo- 
keyboard at node BOSTON and accepts the connection requested by NET. 
Once the connection is established, information that the user types at the 
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keyboard in DENVER is relayed over the logical link to NPKDVR, which 
relays it to the pseudo-keyboard. The RSTS/E system at BOSTON treats a 
pseudo-keyboard as a normal keyboard. When the RSTS/E monitor receives 
information from the pseudo-keyboard (whatever the user types at node 
DENVER), it creates a job and runs LOGIN to process the input. The 
responses made by the monitor, LOGIN, and whatever else the user runs, 
are directed to the pseudo-keyboard. NPKDVR, in turn, passes responses 
directed to the pseudo-keyboard back over the logical link to the NET pro- 
gram. NET then displays it at the user’s terminal. 


NOTE 


Except for the special CTRL/P character and its related 
commands (discussed in the sections that follow), user 
input is passed directly through to NPKDVR on the remote 
system. NET makes no attempt to interpret any of the data 
it passes through. Thus, if the user types a system-level 
command, for example, the command is executed at the 
remote system and has no effect on the local system. 


NPKDVR is itself a job. To reduce overhead, a system manager can install 
one or more permanent copies of NPKDVR at a node. Each such per- 
manently installed copy can handle multiple logical links. When such copies 
are all busy, an incoming connection request causes a temporary copy to be 
automatically started. (See the discussion of the SET/DEFINE OBJECT 
command in DECnet/E System Manager’s Guide for further information on 
installing programs for automatic startup.) 


Running NET 


You can run NET from any terminal in a DECnet/E system by typing the 
following command: 


RUN $NET 
NET responds by identifying itself and then outputing the following prompt: 
Node Name? 


Type a node name, followed by two colons and, optionally, an initial string of 
characters to be forwarded to the remote node. When the connection is 
established, NET prints the following message: 


Connection established to RSTS/E Node nodename 


You can then proceed as though directly connected to the remote RSTS/E 
node. 


If NET has been installed as a Concise Command Language (CCL) com- 
mand, you can also run NET by typing the following command: 


NET [nodename{::[string]]] 
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If you are running under the DCL Run-Time System, you can also connect to 
a remote node by typing the following command: 


SET HOST [nodename[::[string]]] 


Once the connection to the remote DECnet/E node is established, you are 
logically connected to the remote node. You can log in, run programs 
(including NET to establish a connection at yet another DECnet/E node), 
and log out. You can use the special character CTRL/P (Control-P) followed 
by the RETURN key to escape to the NET program at the local node without 
breaking the connection to the remote node. NET will then accept one of the 
commands described in Section 3.2. 


NOTE 


To run a program at the remote node that opens the 
keyboard using field control, echo control, or binary modes 
(as described in the RSTS/E Programming Manual), you 
must first use the ODT command to enter a special trans- 
mission mode (Section 3.2.6). This places a heavy load on 
the network, however, and should only be used as needed. 


3.2 NET Commands 


If you type CTRL/P, followed by RETURN, while using a remote RSTS/E 
node, you will temporarily return to the NET program at the local node. The 
connection to the remote node is not broken, but any characters you type 
will be processed by NET at the local node rather than being forwarded to 
the remote node. NET displays the following prompt: 


nodename::NET> 


The parameter nodename is the name of the “local” node. (If you are using 
NET to run NET at another remote node, this is the name of the node at 
which the remote NET is processing a CTRL/P command. See Section 3.2.2.) 
You can then type one of the following six commands. These commands are 
listed below and described in the sections that follow: 


CONTINUE Continue transmission of input to remote node. 


CTRL/P Transmit a Control-P character to the remote node 

EXIT Terminate transmission to the remote node and exit from 
the NET program. 

HELP Display instructional information. 

NORMAL Resume normal transmission to remote node, one line at a 
time. 

ODT Begin transmission to remote node, one character at a time. 
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3.2.1 CONTINUE Command 


This command causes the NET program to stop displaying its “NET>” 
prompt and resume sending the data typed at the local terminal over the 
connection to the remote node. 


Example: 


RUN NET 

NET V2.0 RSTS V7.1 DECnet System 

Node name? BOSTON 

Connection established to RSTS/E Node BOSTON 

HELLO 

RSTS V7.1 Timesharing Job 31 KB33 15-Aug-81 8:00AM 
#2/218 

Password: (not echoed) 


Ready 


op 
DENVER: :NET?HELP 


(help display) 


DENVER: sNET?CONTINUE 
RUN $DIRECTORY 


+ 


(DIRECTORY display for user 
at node BOSTON) 


+ 
¥ 


+ 


3.2.2 CTRL/P Command 


The CTRL/P command is used to pass on a Control-P character to the remote 
node. This is useful when you are running NET at one remote node to con- 
nect to yet another node. 


Example: 


Consider a network having three DECnet/E nodes named DENVER, BOS- 
TON, and TULSA, with BOSTON as the central node. A user at node DEN- 
VER runs NET as follows: 


RUN $NET 

Node Name? BOSTON: :HELLO 

Connection established to RSTS/E Node BOSTON 

RSTS V7.1 Timesharing Job 31 KB33 15-Aug-81 8:00AM 
#2/218 

Passwords: (not echoed) 


Ready 
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RUN $NET 

Node Name? TULSA: :HELLO 

Connection established to RSTS/E Node TULSA 

RSTS V7.1 Timesharing Job 31 KB33 15-Aug-81 9:01AM 
#1/150 

Password: (not echoed) 


Ready 


RUN $0DT 

#°P 

DENVER: :NET>CTRL/P 
BOSTON: :NET> ODT 

“p 

DENVER: :NET? ODT 


t 


(TULSA’s ODT waiting for input) 


In this example, the user runs NET at the local node (DENVER) and estab- 
lishes a connection with node BOSTON. At node BOSTON, the user again 
runs NET, establishes a connection with node TULSA, and runs ODT at 
TULSA. 


When ODT displays its prompt, the user types a CTRL/P combination fol- 
lowed by a RETURN, escaping to the local NET’s command level. The user 
then types the command CTRL/P, which sends a Control-P character to node 
BOSTON, causing BOSTON’s NET to display its “NET>” prompt. The user 
types ODT, telling BOSTON’s NET to send information to TULSA in the 
single-character mode. The local NET must still be told to send information 
in ODT mode, so the user again types a CTRL/P combination followed by a 
RETURN, escaping to the local NET’s command level. The user then types 
the ODT command and is then ready to type commands to the ODT running 
at TULSA. 


NOTE 


Note that this command consists of the actual character 
string “CTRL/P” rather than the CTRL and P key 
combination. 


3.2.3 EXIT Command 


There are two ways to terminate the NET program. You can simply log out 
at the remote node, or you can use the EXIT command. The EXIT command 
severs the connection with the remote node. NPKDVR at the remote node 
automatically kills the job to which the user is connected. NET displays the 
following message: 


Link to Node nodename disconnected 


This message is followed by two bell characters (an audible noise at your ter- 
minal). NET then exits. 
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Example: 

RUN $NET 

Node Name? BOSTON:: 

Connection established to RSTS/E Node BOSTON 


HELLO 


RSTS V7.1 Timesharing Job 31 KB33 15-Aug-81 8:00AM 
#2/219 
Password: (not echoed) 


Ready (node BOSTON’s Ready prompt) 


RUN $NET 

Node Name? TULSA::HELLO 

Connection established to RSTS/E Node TULSA 

RSTS V7.1 Timesharing Job 22 KBi7 15-Aug-81 9:01AM 
#2,1260 

Password: (not echoed) 


Ready (node TULSA’s Ready prompt) 

RUN SSYSTAT 

(systat display) 

Ready (node TULSA’s Ready prompt) 
BYE/F 

Link to node TULSA disconnected 
Ready (node BOSTON’s Ready prompt) 


“Dp 
DENVER: :NET>EAIT 
Link to node BOSTON disconnected 


Ready (node DENVER’s Ready prompt) 


In this example, the user simply logs off at node TULSA and uses the EXIT 
command to break the link to node BOSTON. 
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3.2.4 HELP Command 


If you type HELP in response to the “NET>” prompt, you will get a help dis- 
play at the terminal. After the help information is displayed, NET displays 
another prompt and you can type another NET command. 


Example: 


RUN $NET 

NET V2.0 RSTS V7.1 DECnet System 

Node name? BOSTON: :HELLO 

Connection established to RSTS/E Node BOSTON 

RSTS V7.1 Timesharing Job 25 KB27 14-Aug-81 10:23AM 
#2/218 

Password: (not echoed) 


Ready 


¢ 


+ 


(work at node BOSTON) 


“Pp 
DENVER: : NET ?HELP 


+ 


(help display) 


4 


DENVER: :NET> 


In the preceding example, the user runs NET at the local node (DENVER), 
requesting a connection to node BOSTON. After the connection is made, the 
user types a standard log-in sequence, the RSTS system at BOSTON dis- 
plays its identifying line and “Ready” prompt, and the user does whatever 
work there he wishes. He then types CTRL/P followed by RETURN to 
return to the local NET program to display the HELP text. After the dis- 
play, NET displays a prompt for another command. 


3.2.5 NORMAL Command 
The NORMAL command is used to stop the single-character input requested 


by the ODT command. It should be used immediately after exiting from a 
program that needs this kind of input. 
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Example: 


(ODT processing at remote node) 


+ 


- 
nM 


Ready 


“p 
DENVER: NET SNORMAL 


+ 


+ 


(continue work at node BOSTON) 


In the preceding example, the user terminates ODT at node BOSTON by 
typing CTRL/Z (displayed as *Z on the terminal), and the BOSTON RSTS/E 
system displays its “Ready” prompt. The user then types CTRL/P to return 
to the local NET program at node DENVER and NET displays its “NET>” 
prompt. (It is not necessary to type the RETURN key after CTRL/P in this 
case. Since the NET program is forwarding each character as it is typed, it 
recognizes the CTRL/P immediately.) The user types NORMAL to stop 
ODT-mode transfers and returns to work at node BOSTON. 


3.2.6 ODT Command 


Normally, RSTS/E programs receiving input from terminals accept an 
entire line at a time — a line being a string of characters terminated by a car- 
riage-return/line-feed combination, an escape character, and so forth. A few 
programs, such as ODT (Octal Debugging Tool), do not wait for an entire 
line but process characters as they are typed. When you run such a program 
at the remote node, you must first issue the ODT command to the NET pro- 
gram at the local node. NET will then forward characters to the remote node 
as you type them. 


NOTE 


Using this feature places a heavy load on the network since 
DECnet must now send many more messages over the link 
than it would normally. ODT mode should be used with 
discretion. 


Example: 


NET BOSTON: HELLO 

Connection established to RSTS/E Node BOSTON 

RSTS V7.1 Timesharing Job 31 KB33 15-Aug-81 8:00AM 
#2/218 

Password: (not echoed) 


Ready 
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RUN $0DT 


#"P 
DENVER: :NET?ODT 
2Z1a/ 1077 


# 
+ 
+ 


+ 


In the preceding example, the user runs NET as a CCL command, request- 
ing a connection to node BOSTON. The string “HELLO” is given as part of 
the command line. Once the connection is accepted, the RSTS/E system dis- 
plays its normal prompt for a project-programmer number and the user pro- 
ceeds with logging in. The user then runs ODT at node BOSTON and when 
ODT prints its pound sign prompt for input, the user types the CTRL/P com- 
bination followed by RETURN to return to the NET command level at the 
local node (DENVER). NET responds with its “NET>” prompt and the user 
types ODT. NET processes the command and returns the user to the remote 
node. (ODT was waiting for input.) The user types an ODT command and 
processing continues as normal. 


3.3 NET Error Messages 


?Connect Failure — Invalid node name nodename 
The node name given in response to the “Node name?” prompt is not 
valid. There is no such node in the network. Run NET again, specifying a 
valid node name. 

?Connect Failure — Node shutting down 
The node requested is scheduled for shutdown. No new logical links can 
be established to the node. Try again later. 

?Connect Failure — Too many links to node nodename 
Network traffic to node nodename is too heavy at the moment to estab- 
lish another logical link. Try again later. 

?Connect Reject — NSP reason code = n 
The remote node rejected NET’s request for a logical link. NSP reason 
codes are given in Appendix B. 

Illegal Command 


The command you typed in response to a “NET>” prompt is not one of 
those recognized by the NET utility. Type HELP to see a display of valid 
commands. 
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Chapter 4 


NFT: Network File Transfer Utility 


As the name implies, the main function of the Network File Transfer utility 
(NFT) is to move files from one node to another (see Figure 4-1). You can 
run NFT from a terminal to perform the following functions: 


Copy files from a storage device at one node to a storage device or output 
device at another node. 


Copy and append one or more files stored at one node to a file stored at 
another node. 


Copy and submit a command file stored at one node to another node’s 
batch processor or indirect command interpreter for execution. On 
RSTS/ nodes, such files are submitted to the batch processor. 


Execute an existing command file at a remote node. 
Delete files stored on a disk at a remote node. 
Copy and spool print files from one node to another node’s printer 


Obtain a directory listing of files stored on disk at a remote node. 


NOTE 


Even though NFT is written to conform to the Data Access 
Protocol (DAP), Version 5.6, it still supports only the execu- 
table bit during file transfers; file protection codes are not 
passed. Thus, files created as a result of NFT commands 
have a protection code of either <60> or <124>, depending 
on the presence of the executable bit. 
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RUN $NFT 
NFT>COPY DALLAS::NEW.BAS=BOSTON: :MY.BAS 


NODE: BOSTON 
PPN: 120,123 
PASSWORD: (not echoed) 
ACCOUNT: (none needed) 
NODE: DALLAS 
PPN: 104,160 
PASSWORD: (not echoed) 
ACCOUNT: (none needed) 
NFT> 

Ready 


BOSTON 


DENVER 


NFT provides file protection by 
prompting for log-in information 
for remote nodes. 


Figure 4-1 NFT Transfers Files to, from, and between Remote Nodes 
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4.1 Background 


It is easier to understand what NFT does by beginning with a brief descrip- 
tion of how the file transfer capability is implemented in DECnet/E. 


The features listed in the introduction to this chapter are actually provided 
by three software modules — NFT, the File Access Listener (FAL), and the 
Record Management Services (RMS). 


NFT establishes a logical link with a FAL program at the remote node. It 
then accepts commands typed by the local user and transmits them to FAL. 
The FAL program, a part of DECnet, does whatever is necessary on its end 
to execute the commands. NFT and FAL communicate with each other in a 
language defined by the Data Access Protocol (DAP) for DECnet in general. 
Thus, even though the user commands can be different for various DECnet 
implementations of NFT, all DECnet systems having NFT and FAL can 
communicate to do file handling. 


RMS is a file service feature used by NFT and FAL at DECnet/E nodes to 
execute input and output to the local I/O devices. This is of interest mainly 
because non-RSTS/E nodes can use other means to do their local file I/O and 
can require some of the special switches described in Section 4.5. These 
switches ensure that files transferred between nodes with different oper- 
ating systems and file systems are transferred in a usable format. Figure 
4-2 illustrates the interaction between NFT, FAL, and RMS at two DEC- 
net/E nodes. 


NFT CONNECTS WITH REMOTE FAL 
THEY COMMUNICATE ACCORDING 


TO DAP PROTOCOL 
NFT USES FAL USES 
RMS TO DO RMS TO DO 
LOCAL 1/0 LOCAL 1/0 


Figure 4-2 At DECnet/E Nodes, NFT, FAL, and RMS Work Together to 
Allow File Operations 
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Running NFT 


You can run NFT from any terminal in a DECnet/E system by typing: 
RUN $NFT 


Or, if NFT has been installed by the system manager as a Concise Command 
Language (CCL) command, you can simply type: 


NFT 


In either case, NFT responds with the prompt NFT> and will accept one 
command per line until CTRL/Z or “EXIT” is typed in response to a prompt: 


NFT> command-1 
NFT> command-2 


NFT> command-n 
NFT> *Z 


If NFT has been installed as a CCL command and you want to use only one 
NFT command, you can type NFT and the command on one line, as follows: 


NFT command 


NFT executes the command and immediately returns control to the RSTS/E 
monitor. 


NOTE 


If you are running under the DCL Run-Time System, the 
NFT functions can be invoked by issuing the appropriate 
DCL command (e.g., COPY, DELETE, PRINT, etc.). Since 
the syntax of these DCL commands differs significantly 
from the NFT commands described in this chapter, refer to 
the RSTS/E DCL User’s Guide for details on using the DCL 
commands. 


To protect files from unauthorized use or destruction, an NFT user must 
supply log-in information for any node referred to in a command. There are 
five methods for supplying this information: 


1. You can use the NETACT utility to provide the information in a file 
that NFT can use each time it is run (see Appendix C). 


2. You can use the NODESPECIFICATION command (see Section 
4.4.7). 


3. You can supply the information as an extension of the remote node 
specification (see Section 4.3.1). 


4. You can use the /IDENTIFY switch to request that NFT prompt for 
the information on a one-time basis (see Section 4.5.8). 
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5. Or, you can simply do nothing and force NFT to prompt for the infor- 
mation. (NFT will prompt you if you refer to a remote node in a com- 
mand and have not specified the log-in information in any other 
fashion.) 


In three of these cases (NETACT file, NODESPECIFICATION command, 
and NFT prompting), once log-in information is specified for a particular 
node, it is used throughout the NFT run each time that node is referenced, 
unless it is changed, overridden, or rejected by the remote node. In the other 
two cases (node name extension and the /IDENTIFY switch), the informa- 
tion is used to override the existing log-in information for one command 
only. 


However specified, NFT uses the log-in information to gain access to the 
remote file system before executing any command affecting a file at a remote 
node. If the information given is valid, you can access any files that you 
could when directly logged in to the remote system under the specified 
account. 


4.3. General Format of NFT Commands 


A DECnet/E NFT command consists of a command keyword (defining an 
action) and variable parameters (defining the nodes and files involved in the 
action). In addition, switches can be used when necessary to further define 
the action to be performed. For example: 


COPY DENVER: :FILE.LST/SU=DALLAS: sMYFILE.TAT 


COPY is the command keyword, indicating that the file on the right of the 
equal sign (MYFILE.TXT at node DALLAS) is to be copied to the node 
named DENVER under the name FILE.LST. The /SU switch indicates that 
if a file already exists on node DENVER called FILE.LST, it will be super- 
seded by the file being transferred. 


Command and switch keywords can be abbreviated. In general, the first two 
characters of the keyword are all that is necessary. Some switches, however, 
require four characters to identify the switch. For example: /NOHEADING, 
/NOSUPERSEDE, and /NODELETE. 


The commands and switches recognized by the DECnet/E implementation of 
NFT are described in Sections 4.4 and 4.5. Most of the user-supplied argu- 
ments identify files to be manipulated by NFT. The following general com- 
ments apply. 


4.3.1 Node Names 
DECnet/E NFT can be used to manipulate files to, from, and between remote 
nodes. NFT will also work with files at the local node, although it is gener- 


ally more efficient to use the RSTS/E utilities designed to manipulate files at 
the local node. 
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The network shown in Figure 4-3 will be used as an example throughout 
this chapter. To illustrate file transfers among DECnet nodes with different 
operating systems, BOSTON and DENVER are DECnet/E nodes (RSTS/E 
operating system); DALLAS is a DECnet/11M node (RSX—11M operating 
system); and MIAMI is a DECnet/RT node (RT-11 operating system). 


DECnet/E 
NODE: BOSTON 


LOCAL DECnet/E 
NODE: DENVER 


DECnet/11M 
NODE: DALLAS 


DECnet/RT 
NODE: MIAMI 


REMOTE-TO-REMOTE 
OPERATIONS ALLOWED 


Figure 4-3 Sample Network Showing Transfers between Nodes with 
DECnet/E NFT 


To identify the remote node where a particular file is located or to which it is 
to be moved, the 1- to 6-character, alphanumeric node name is given. The 
node name must contain at least one letter and is followed by two colons (::) 
to separate it from the file specification. (Names of currently active nodes in 
the network can be determined with the NCP command SHOW ACTIVE 
NODES, described in the DECnet/E System Manager’s Guide.) If the local 
node name is specified in an NFT command, FAL is run at the local node. 


As mentioned in Section 4.3.1, the log-in information required by NFT to 
access files at the remote node can be specified as an extension of the node 
name. If included, this information must be in the following format: 


nodename “[user-id] [password] [account-id)’:: 


The parameters user-id, password, and account-id are the same as described 
with the NODESPECIFICATION command (see Section 4.4.7). They are 
separated by either a space or a horizontal tab character and are enclosed in 
double quotes. 


As with quoted strings (see Section 4.3.4), NFT simply removes the quotes 
and passes the characters they enclose to the remote system without exam- 
ination. In some circumstances, this means that the accounting information 
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is processed differently than if it had been specified with the NODESPECI- 
FICATION command, through the NETACT program, or with prompting. 
For example, consider the case where the remote system is running the 
VAX/VMS operating system. Since VMS does not permit nonoctal user iden- 
tification codes, NFT ordinarily converts the specified user-id to the VMS- 
compatible octal equivalent. However, if the log-in information is included 
with the node name, enclosed in quotes, no conversion is done and errors 
may result. 


4.3.2 File Specifications 


The way in which files are identified depends on the operating system at the 
node where the file is located. For file specification formats used with non- 
RSTS/E nodes, consult the documentation for the appropriate operating 
system. 


For files at RSTS/E nodes, the file specification is a subset of the full RSTS/E 
file specification. The elements used (device, project-programmer number, 
file name, and type) follow the rules for RSTS/E file specification. 


dev:[ppn)filename.typ 


The dev item is a device designation. If this is omitted, the system disk (SY:) 
is assumed. 


Although you can refer to specific devices at the local or remote nodes, you 
are responsible for seeing that tapes are mounted and positioned properly, 
and so forth. If a device is busy, NFT will return an error message. You can 
use the ASSIGN and DEASSIGN commands at the local node to reserve 
local devices. 


NOTE 


It is currently more practical to use NFT to move files 
between disk structures (either public or normally mounted 
private disks) at each node than to request transfer to or 
from another type of device. For example, suppose you are 
using NFT to transfer a file to the local node for transfer to 
a magnetic tape. Use NFT to transfer the file to public disk 
and then use PIP to transfer the file to magtape. (The 
RSTSI/E System User’s Guide describes how to use PIP.) 


The ppn is the project-programmer number identifying the directory in 
which the file is located — for example, [100,201]. (On some DIGITAL sys- 
tems, the ppn is called a user identification code, or UIC.) If omitted, the ppn 
is assumed to be the user ID specified during the NFT log-in sequence (with 
the NODESPECIFICATION command, NFT’s prompting, or through the 
NETACT utility) for the node being referenced. Access to another ppn 
depends on the user’s privilege at the node in question. (Note that some 
DIGITAL systems permit alphanumeric directory names to be assigned 
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equivalent to the project-programmer number. If the remote system permits 
such names, they can be used in the file specification.) 


NOTE 


If a ppn is given, the square brackets (or parentheses) must 
be used. 


The filename.typ is the file name and type. For files on RSTS/E nodes, the 
filename can be up to 6 alphanumeric characters, and typ can be up to 3 
alphanumeric characters. If a command accepts both an input and an output 
file specification and the output specification is omitted, NFT will default 
the output file specification to that supplied for the input file. If typ is 
omitted, NFT does not supply a default. 


4.3.3 Wildcards 


NFT permits wildcard characters in file specifications, allowing the user to 
select a set of files for sequential file retrieval, file deletion, file spooling, 
directory listings, or command file execution. The format of the wildcard 
syntax depends on the capabilities of the remote node to process the file 
specification. 


When wildcards appear in the output file specification of certain commands, 
names are duplicated on a one-to-one basis during the operation as specified 
by the wildcards. For example, consider the following COPY commands: 


COPY *.DAT=DALLAS::CCOWBOY1]*.LST 
COPY *,DAT=DENVER::Ci+sQ4]FILEA.LST+(9,12]FILEB.LST 


On receiving the first command, NFT copies every file from the directory 
COWBOY on node DALLAS with the type .LST to a file on the local node in 
the current directory with the same file name but with a type of .DAT. 


The second command causes NFT to copy FILEA.LST from directory [1,34] 
on node DENVER to FILEA.DAT in the current directory on the local node 
and FILEB.LST from directory [3,12] on node DENVER to FILEB.DAT, also 
in the current directory on the local node. 


DECnet/E Guide to User Utilities 


In most cases, when the input file specification contains wildcards but the 
output file specification contains none, the input files are all concatenated 
into the one output file. For example, consider the first example shown pre- 
viously, slightly modified: 


COPY MASTER.DAT=DALLAS: :CCOWBOYI*.LST 


This command causes NFT to copy every file with the type .LST from direc- 
tory COWBOY on node DALLAS to a single file MASTER.DAT in the cur- 
rent directory on the local node. Each of the files located with the type .LST 
is appended, in sequence, into a single output file named MASTER.DAT. 


In this circumstance, as with the APPEND command (see Section 4.4.1) and 
the /APPEND switch (see Section 4.5.1), the user must be aware of the attri- 
butes of the individual source files. Concatenating an image file with an 
ASCII file, for example, can have unpredictable results, depending on how 
the final destination file is to be used; an error message may or may not be 
generated. Thus, when using wildcards in the source file specification in this 
fashion, it can be useful to apply the /INQUIRY switch (see Section 4.5.10). 
As each input file is located, the user can then make a decision as to whether 
or not the file should be included in the operation. 


4.3.4 Quoted Strings 


Quote characters can be used in commands to tell the local NFT not to exam- 
ine the characters enclosed by the quotes. In general, when NFT encounters 
paired double quotes (“text”) or single quotes (‘text’), it removes the quotes 
and passes the characters they enclose to the remote system without exam- 
ination. This is useful when it is necessary to include characters in a file 
specification for a remote, non-RSTS system that the local NFT recognizes 
in its own analysis of a command. 


For example, suppose you want to copy a file to a DECnet/RT node and you 
want to use the RT-11 file system’s switch for allocating a specific amount of 
storage space for the file. This switch is of the form /B:n. To prevent the local 
NFT from interpretting the slash and trying to parse the switch as one of its 
own (Section 4.5), you can enclose the file specification in quotes: 


COPY RTNODE::"FILE.LST/B:200"=LOCFIL.1 


The local (RSTS/E) NFT also treats pairs of square brackets —[ ] — paren- 
theses — ( ) — and angle brackets — < > - ina similar manner. It does not 
remove these pairs, however, but passes them on, along with the characters 
they enclose, without examination. These characters can be used for access 
to either the local or a remote node. (At a DECnet/E node, local or remote, 
the characters enclosed would be passed on directly to RMS.) 


NFT: Network File Transfer Utility 4-9 


4.4 NFT Commands 


There are twelve NFT commands available. Each command is discussed in 
detail in the following subsections. The commands available are: 
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APPEND 


COPY 
DELETE 
DIRECTORY 


EXIT 

HELP 
NODESPECIFICATION 
PRINT 


SUBMIT 


TYPE 
VERSION 
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Append file(s) from one node to a file on 
another. 


Copy file(s) from one node to another. 
Delete file(s) at a remote node. 


Obtain a directory listing of files at a remote 
node. 


Exit from NFT. 
Obtain instruction information. 
Enter remote node log-in information. 


Spool file(s) from one node to the line printer of 
another node. 


Submit file(s) from one node for execution on 
another node. 


Display file(s) on the terminal console. 


Display the local NFT or remote FAL version 
number. 


4.4.1 APPEND Command 


The APPEND command transfers one or more files from one node to 
another, appending them to the end of an existing file at the target node. 


NOTE 


When invoking this command, the user should be aware of 
the attributes of the files to be appended and ensure that 
the files are compatible. Appending a variable-length 
record file to one with fixed-length records, for example, can 
have unpredictable results. An error message may or may 
not be output. 

Command Format: 


APPEND [dstnode:: Joutfile =[srenode::]filel|,...,filen] 


Parameter Descriptions: 
dstnode 


The dstnode is the name of the node containing the file to which the other 
files are to be appended. If omitted, the local node is assumed. 


outfile 


The outfile is the file specification of the existing file to which the others are 
to be appended. 


The equal sign separates the destination and source specifications. 
srcnode 


The srcnode is the name of the node from which the files are to be copied. If 
omitted, the local node is assumed. 


file7,... 


These are the file specifications for the files to be transferred and appended. 
They will be appended to the end of ouffile, in the order specified. 


Example: 
NFT> APPEND DALLAS: :ACCT.BAS=AACCT.BAS »BACCT.BAS 


In this example, the files AACCT.BAS and BACCT.BAS are copied from the 
local node and appended to the file ACCT.BAS at node DALLAS (Figure 
4-4), 
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APPEND DALLAS::ACCT.BAS = AACCT.BAS, BACCT.BAS 


BOSTON 


APPEND to 
form one file 


ACCT.BA? 


Figure 4—4 Example of the APPEND Command 
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4.4.2 COPY Command 


The COPY command copies one or more files from one node to one or more 
files at another node. The files are not deleted at the source node. COPY is 
the default command for NFT; the command keyword COPY can be omitted 
entirely. 


Command Format: 

[COPY] [dstnode::][outfile][ = srcnode::]file]....,filen] 
Parameter Descriptions: 

dstnode 


The dstnode is the name of the destination node to which the file(s) are to be 
transferred. If omitted, the local node is assumed. 


outfile 


The outfile is the file specification to be given to the transferred file(s) at the 
destination node. If no wildcards are used, the input files are concatenated 
in the order specified to form outfile. If wildcards are used, each output file 
created at the destination node will have the outfile specification, as speci- 
fied by the wildcards in the input file names. 


The equal sign separates the destination and source specifications. 
srcnode 


The srcnode is the name of the source node from which the file(s) are to be 
copied. If omitted, the local node is assumed. 


fileT,... 


These are the file specifications for the files stored at the source node that 
are to be copied. 


The equal sign is only required if a dstnode or outfile specification is 
included in the command. If all three items are omitted, the input files 
(filen) will be copied to the user’s keyboard console. If dstnode and outfile are 
omitted but the equal sign is not, the output file is assumed to be vere, 


Example: 
NFT> AFIL,BAS=BOSTON: :AFIL.BAS 
NFT> BFIL.BAS=BOSTON: :BFIL.BAS 


NFT > CO DKi:MYFILE.BAS=BOSTON: :AFIL.BAS+BFIL.BAS 


NFT? COPY DALLAS::NEWFIL.BAS=BOSTON: :AFIL.BAS»BFIL.BAS 
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In all these examples, files AFIL.BAS and BFIL.BAS are copied from the 
node named BOSTON (see Figure 4-5). In the first two commands, the files 
are copied to the local node’s system disk as separate files named AFIL.BAS 
and BFIL.BAS, the same names they had at node BOSTON. In the third 
command, they are copied and concatenated to form a file named 
MYFILE.BAS on disk DK1 at the local node. In the fourth command, they 
are copied to form a file named NEWFIL.BAS on the public disk at node 
DALLAS. 


AFIL.BAS = BOSTON: :AFIL.BAS 
BFIL.BAS = BOSTON: :BFIL.BAS 


COPY DK1:MYFILE.BAS = BOSTON. AFIL.BAS.BFIL.BAS 


COPY DALLAS::NEWFIL.BAS = BOSTON::AFIL.BAS.BFIL.BAS 


AFIL.BAS 
BOSTON 
ae a AFIL.B AS 
DENK ER eee” eget SFIL.BAS 
Co eee O- == alee : 
====-9-7---O- 
oD ee 
a “on 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ DALLAS 
= NX 


Figure 4-5 Examples of the COPY Command 
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4.4.3 DELETE Command 


The DELETE command deletes the specified files. These files must exist on 
disk; tape files cannot be deleted with this command. 


Command Format: 

DELETE [dstnode::]filel{,...,filen] 
Parameter Descriptions: 
dstnode 


The dstnode is the name of the remote node at which the files to be deleted 
are located. If omitted, the local node is assumed. 


fileT,... 


These are the file specifications for those files to be deleted. These files must 
reside on disk; no tape file deletions are allowed. 


Example: 


NFT> DELETE MIAMI::FIL.RNO+BINFIL.SAV+RM.BAS 


The files FIL.RNO, BINFIL.SAV, and RM.BAS are deleted from the public 
disk at node MIAMI (see Figure 4-6). 


DELETE MIAMI:: FIL. RNO,BINFIL.SAV,RM.BAS 


BOSTON 


DENVER 


DALLAS 
FILES DELETED 


Figure 4-6 Example of the DELETE Command 
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4.4.4 DIRECTORY Command 


The DIRECTORY command displays a directory listing of files located at a 
remote node. 


Command Format: 

DIRECTORY [dstnode::][outfile][ = [srcnode::]file1[,...,filen] 
Parameter Descriptions: 

dstnode 


The dstnode is the name of the destination node on which the directory list- 
ing is to be created. If omitted, the local node is assumed. 


outfile 


The outfile is the specification of the file to receive the output listing. If it is 
omitted, the listing is output to the console on the destination node. If the 
file currently exists, its contents are overwritten unless the /APPEND 
switch is used (see Section 4.5.1). 


The equal sign separates the destination and source specifications. 

srcnode 

The srenode is the name of the node at which the files to be listed are located. 
fileT,... 


These are the specifications of the files to be listed. They must exist at the 
source node. 


The equal sign is only required if a dstnode or outfile specification is 
included in the command. If all three items are omitted, the directory listing 
is output to the user’s console. 


Example: 


DIRECT DENVER: 07 +214] %,% 


A complete listing of all files in account [7,214] on the system disk of node 
DENVER is displayed at the local console. 
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DIRECT DENVER: : [7,214] *.* 


LISTING OF ALL 

FILES IN [7,214] ON 
NODE DENVER OUTPUT 
TO LOCAL CONSOLE 


BOSTON 


[7,214] 


DENVER 


DALLAS 


MIAMI 


Figure 4-7 Example of the DIRECTORY Command 
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4.4.55 EXIT Command 


The EXIT command is used to terminate execution of NFT. It is equivalent 
to typing CTRL/Z. ; 


Command Format: 
EXIT 
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4.4.6 HELP Command 


The HELP command is used to display information about the commands 
and switches available with DECnet/E NFT. 


Command Format: 


HELP COMMANDS 
SWITCHES 


If neither COMMANDS or SWITCHES is specified, both sets of information 
are displayed. 


The HELP command does not involve network access. 


NFT: Network File Transfer Utility 4-19 


4-20 


4.4.7 NODESPECIFICATION Command 


The NODESPECIFICATION command allows you to enter or change the 
log-in information required to establish you as a valid user at a remote node. 
This information is kept and used in subsequent references to the node for 
this particular execution of NFT. 


You do not have to use this command to define initial log-in values, how- 
ever. NFT prompts for log-in information each time you refer to a node for 
which you have not yet given any log-in information. This log-in informa- 
tion is also kept and used for the entire run or until it is changed with 
another NODESPECIFICATION command. 


(Log-in information can be altered on a one-time basis for a single command 
with either the node name extension (see Section 4.3.1) or with the 
/IDENTIFY switch (see Section 4.5.8).) 


Command Format: 
NODESPECIFICATION [nodename::] 
Parameter Descriptions: 

nodename 


The nodename is the name of the node at which you wish to be validated as 
an established user. If omitted, NFT lists the nodes you have already speci- 
fied, if any, along with the log-in information you gave for the nodes. 


If nodename is given, NFT prompts for log-in information, first redisplaying 
the node requested. 


Node: nodename 
User: ppn 
Password: password 
Account: account-id 


After each prompt, you type the appropriate information. The ppn is the 
project-programmer number (sometimes referred to as a user identification 
code or UIC) used for logging in at the remote node. It can be up to 16 char- 
acters long. If the remote node permits alphanumeric named directories in 
addition to or in place of numeric project-programmer numbers, you can 
specify the ppn in that form. 


The password is a 1- to 8-character string; the account-id can be up to 16 
characters. If a password is entered, it is not echoed at the terminal. 


If a particular item, such as the account-id, is not used for log-in at the 
remote node, you can omit it by entering only a carriage return in response 
to the prompt. 
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Example: 


NFT> NO BOSTON:: 


Node: BOSTON 
Users: iZo%4 
Password: 

Accounts Ret 
NFT> 


NFT, having accepted the log-in information, is ready to accept another 
command. Note that that password, although entered, did not echo on the 
terminal. 
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4.4.8 PRINT Command 


The PRINT command copies one or more files from disk at one node to one or 
more temporary files at another node for input to the line printer spooler. 
After the temporary file is printed, it is deleted from the destination node 
unless the /NODELETE switch is used. The destination node must, of 
course, have a line printer spooler. 


Command Format: 

PRINT [dstnode::][outfile]| = l[srenode::]file][....,filen] 
Parameter Descriptions: 

dstnode 


The dstnode is the name of the node to which the files are to be copied, 
printed, and deleted. If the node name is omitted, the local node is assumed. 


outfile 


The outfile is the name of the temporary file at dstnode. If this specification 
contains no wildcards, the input files will be concatentated into a single out- 
put file and printed. If wildcards are specified, multiple temporary files will 
be created and printed at the destination node, with file names created 
according to the wildcards in the input specification. If the destination is a 
RSTS/E node, outfile must be a disk file. 


The equal sign separates the destination and source specifications. 
srcnode 


The srcnode is the name of the node from which the files are to be copied. If 
omitted, the local node is assumed. 


file... 


These are the files to be copied from srcnode and printed. These files must be 
on disk. 


The equal sign is only required if the dstnode or outfile is specified. If both 
are omitted, the input files will be queued to the line printer spooler at the 
source node. In this case, the file is not deleted after printing unless the 
/DELETE switch is used (see Section 4.5.6). 


Example: 


NFT?> PRINT DENVER: :TEXT.DOC=MIAMI::BOOK?.DOC 


All files at node MIAMI with file names beginning with BOOK and with the 
type .DOC are concatenated and copied to a temporary file named 
TEXT.DOC at node DENVER. File TEXT.DOC is then printed and deleted 
(see Figure 4-8). 
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PRINT MIAMI:: TEXT.DOC = BOSTON:: BOOK?.DOC 


BOSTON 


TEXT.DOC 
TEMPORARY 
FILE 


DENVER 


COPIED AND SUBMITTED 
TO SPOOLER, LISTED, LISTING 
AND DELETED. 


DALLAS 


Figure 4-8 Example of the PRINT Command 


NFT: Network File Transfer Utility 4-23 


4-24 


4.4.9 SUBMIT Command 


The SUBMIT command copies one or more files from one node to one or more 
temporary files at another node for execution. After execution, the command 
file is deleted from the destination node unless the /NODELETE switch is 
used. The destination node must be able to execute command files and the 
files must be in the proper format for execution at that node. For RSTS/E 
nodes, the files are submitted to BATCH, the batch processor. (The RSTS/E 
System User’s Guide discusses the command file format for BATCH.) 


Command Format: 

SUBMIT [dstnode::][outfile][ = \[srcnode::}file]|,...,filen] 
Parameter Descriptions: 

dstnode 


The dstnode is the name of the node to which the command files are to be 
copied, executed, and deleted. If the node name is omitted, the local node is 
assumed. 


outfile 


The ouwéfile is the name of the temporary file to be created at dstnode. If this 
specification contains no wildcards, the input files will be concatentated into 
a single output file and submitted for execution. If wildcards are specified, 
multiple temporary files will be created and submitted at the destination 
node, with file names created according to the wildcards in the input 
specification. 


The equal sign separates the destination and source specifications. 
srcnode 


The scrnode is the name of the node from which the files are to be retrieved. 
If omitted, the local node is assumed. 


file... 
These are files to be copied from srcnode and executed. 


3 The equal sign is only required if dstnode or outfile is specified. If both are 
omitted, the input file(s) already existing at the source node are submitted 
to the batch processor on that node. In this circumstance, the files are not 
deleted after execution unless the /DELETE switch is used (see Section 
4.5.6). 


Example: 


NFT> SUBMIT BOSTON: :RBAT.CTL=*.CTL 


All files at the local node with a type of .CTL are copied into a temporary file 
called RBAT.CTL at node BOSTON, executed, and deleted (see Figure 4-9). 
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SUBMIT BOSTON:: RBAT, CTL=*,CTL 


BOSTON. 


7" a 
&m porary FY 


COPIED AND 
SUBMITTED 
TO BATCH, 
EXECUTED 
AND DELETED, 


DENVER 


MIAMI 


Figure 4-9 Example of the SUBMIT Command 


NFT: Network File Transfer Utility 4-25 


4.4.10 TYPE Command 


The TYPE command displays the input files from the source node on the 
user’s terminal display. It is equivalent to the COPY command when every- 
thing to the left of (and including) the equal sign is omitted. 


Command Format: 

TYPE [srenode:: |filel[,...,filen] 
Parameter Descriptions: 
scrnode 


The srcnode is the name of the source node from which the file(s) are to be 
retrieved. If omitted, the local node is assumed. 


file7.... 


These are the file specifications for the files stored at the source node that 
are to be typed on the user’s console. 


Example: 


NFT> TY DALLAS::DAILY.SUM 


In this example, the file DAILY.SUM is retrieved from the public disk on 
remote node DALLAS and typed out on the user’s keyboard console (Figure 
4-10). 


TY DALLAS::DAILY.SUM 


DENVER 


DALLAS 


MIAMI 


Figure 4-10 Example of the TYPE Command 
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4.4.11 VERSION Command 


The VERSION command is used to display the version numbers of the local 
DECnet/E NFT program or the remote FAL program, as well as the version 
number of the Data Access Protocol (DAP) being used. 


Command Format: 
VERSION [srenode::] 
Parameter Descriptions: 
srcnode 


The srcnode is the name of the node at which the version number of FAL is 
to be examined. If this parameter is omitted, the version number of the local 
NFT is displayed, along with the version number of DAP. 
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4.5 NET Switches 


The switches listed below can be used in NFT commands. Most of these 
switches apply only to certain commands and some can apply only to the 
source or destination file specification. In general, a switch is appended to a 
file specification and it applies to that file only. More than one switch can be 
used as long as they are logically consistent. 


/APPEND 
/ASCII 
/BLOCK 
/BRIEF 


/CONTIGUOUS or /CTG 


/DELETE 


/FULL 
ADENTIFY 
AMAGE 
ANQUIRY 

/LIST 

[LOG 

/MORE or - 
/NATIVE 
/NOCONTIGUOUS 
/NODELETE 
/NOHEADING 
/NOSUPERSEDE 
/POS 

/RWC 

/RWO 
/SUPERSEDE 
‘TOTAL 
/VARIABLE 
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Append input file(s) to output file. 

Data being transferred is ASCII 7-bit data. 
Transfer image data in 512-byte blocks. 
Generate an abbreviated directory listing. 
Allocate space contiguously. 


Special-case delete for SUBMIT and PRINT 
commands. 


Generate an extended directory listing. 
Have NFT prompt for log-in information. 
Data being transferred in 8-bit data. 
Verify input file before function execution. 
Generate a normal directory listing. 
Output file name after function execution. 
Continue command input on next line. 
Reformat file to stream ASCII. 

Allocate space noncontiguously. 

Do not delete temporary file. 

Generate directory listing with no header. 
Do not supersede an existing file. 

Position magnetic tape to end of volume. 
Rewind magnetic tape on close. 

Rewind magnetic tape on open. 

Supersede an existing file. 

Output directory size only. 


Reformat file to variable format. 


4.5.1 /APPEND — Append Input to Output 


The /APPEND switch can be applied to the destination file specification in 
the COPY and DIRECTORY commands. When used with the COPY com- 
mand, the effect is equivalent to the APPEND command; the input files are 
appended to the output file. 


NOTE 


When using this switch with the COPY command, the user 
should be aware of the attributes of the files to be appended 
and ensure that the files are compatible. Appending a vari- 
able-length record file to one with fixed-length records, for 
example, can have unpredictable results. An error message 
may or may not be output. 


When used with the DIRECTORY command, applied to an existing output 
file, the resulting directory listing is appended to the specified file rather 
than overwriting it. 


Example: 


NET? COPY TEXT.DOC/APP=DALLAS: :BOQK??.DOC 
NFT? DIRECTORY DIRECT.LST/AP=E7:2141%.BAS 


4.5.2 /ASCIl- Transfer 7-Bit ASCII Data 


This switch is used to indicate that a transmitted file contains 7-bit ASCII 
data. It can be applied to the source file specification of the COPY, TYPE, 
SUBMIT, APPEND, or PRINT commands. 


Example: 


NFT> COPY MIAMI: :MEMO.DOC=E7+214INOTES.TXT/ASC 


4.5.3 /BLOCK — Transfer Image Data in 512-Byte Blocks 


This switch is used when transferring image (binary) files with the COPY or 
APPEND commands. It should be applied to the source file specification, and 
causes the files to be transferred in 512-byte blocks. 


Note that the /BLOCK switch is generally only applicable for RSTS to RSTS 
file transfers since other operating systems do not fully support binary block 
transfers. The switch is necessary for non-ASCII files that do not have 
recorded attributes. On RSTS/E systems, such files include compiled 
BASIC-PLUS files (file types = .BAC), record-I/O or virtual array data 
files, and binary files such as those with file types of .OBJ or SAV. The 
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switch should not be used, however, for files that have record attributes (e.g. 
MAC.TSK object modules). Using the /BLOCK switch results in a BLOCK 
image copy of the file, with the original attributes being lost. Thus, the 
/BLOCK switch should be used only with unattributed files. 


Example: 


NFT> COPY STORBN.BAC=BOSTON: :COMP.BAC/BL 


NOTE 


The /BLOCK switch is incompatible with and should not be 
used with either the /NATIVE switch (described in Section 
4.5.14) or the /VARIABLE switch (described in Section 
4.5.24). 


4.5.4 /BRIEF — Output a Brief DIRECTORY Listing 


The /BRIEF switch can be used at the end of the DIRECTORY command to 
give a brief directory listing including device, directory, file name, and file 
type. This listing is similar to the listing generated by the RSTS/E PIP 
program. 


Example: 


NFT?> DIR QUICK.DIR=MIAMI::07+214]%,D0C/BR 


4.5.5 /CONTIGUOUS or /CTG - Allocate Space Contiguously 


This switch can be applied to the destination file specification in the COPY, 
SUBMIT, or PRINT command. It allocates contiguous space for the destina- 
tion file(s). If a contiguous allocation cannot be made, the command will fail. 


Example: 
NFT> COPY DALLAS::FILE1.TSK/CO=MYFILE.TSK 
In this example, contiguous space is allocated at node DALLAS (an RSX- 


11M node) for the binary file FILE1.TSK, consisting of the file 
MYFILE.TSK transferred from the local node. 


4.5.6 /DELETE — Delete Files on Close 
This switch can be applied to any file specification in any command. It is 


used to delete the indicated file upon successful completion of the specified 
function. 
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The primary use of this switch applies to the source file specification of the 
SUBMIT or PRINT commands when no destination file specification is sup- 
plied — that is, when the files to be printed or submitted to the batch proc- 
essor already exist at the desired node. With this form of these two 
commands, the files are not automatically deleted since they are, in fact, the 
source files and not temporary destination files. Using the /DELETE switch 
in this case will cause the files to be deleted at the conclusion of the 
operation. 


Example: 


NET? PRINT ROUGH.DRF/DELETE 


4.5.7 /FULL— Output a Full DIRECTORY Listing 


The /FULL switch can be used at the end of the DIRECTORY command to 
give a directory listing including device, directory, file name, file type, file 
size, protection code, creation date and time, as well as a listing of the sym- 


bolic attributes. This listing is similar to the full directory listing generated 
by the RSTS/E PIP program. 


Example: 


NFT? DIR DALSYS.DIR=DALLAS: :S5Y:Cis2]*.*/FULL 


4.5.8 /IDENTIFY —Prompt for Log-in Information 


This switch can be applied once to both the source and destination specifica- 
tions of any command. It causes NFT to prompt for log-in information. The 
information you give in response to this prompting is used only for the cur- 
rent operation. It is not kept for the rest of the NFT execution. After the exe- 
cution of a command with this switch, the log-in information reverts to what 
was previously specified for the node, if any. 


If the IDENTIFY switch is applied to both the source and destination speci- 
fications, NFT prompts for information for the source node first. A second set 
of prompts is used to obtain information concerning the destination node. 


Example: 


NFT> COPY BOSTON: :FILE1.TXT/ID=DALLAS: :FILE3.TAT+FILE4.TXT/ID 


Node: DALLAS 
User: 120;+150 
Password: 
Accounts: 
Node: BOSTON 
Users 30117 
Password: 
Accounts: 
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NFT uses the log-in information to copy the files and then deletes the log-in 
information from its internal records. Previously specified log-in informa- 
tion for BOSTON and DALLAS, if any, is restored for use in subsequent 
commands. Note that the password is not echoed on the keyboard. 


4.5.9 /IMAGE — Transfer 8-Bit Image Data 


This switch is used to indicated that a transmitted file contains 8-bit image 
data. It can be applied to the source file specification of the COPY and 
APPEND commands. 


Example: 


NFT? APPEND DALLAS: :TOTALS.DAT=BOSTON: :£1 +34]DAILY.SUM/ IMAGE 


4.5.10 /INQUIRY — Prompt for Input File Verification 


The /INQUIRY switch can be applied to the source file specification the 
APPEND, COPY, SUBMIT, PRINT, TYPE, and DELETE commands. It is 
used to request that the name of each input file be displayed for verification 
before the file is opened and the indicated function is performed. After the 
name is displayed the user can respond to the prompt with either Y[ES] or 
N[O] to indicate whether the operation should, in fact, be performed on that 
particular file. Ifa NO response is given, the file is skipped and the next file 
name is displayed. 


Example: 


NFT> DELETE MIAMI::(07+2141*,.DO0C/IN® 


This switch is especially useful when the destination file specification does 
not contain wildcards and the source files are to be concatenated into one 
file. In this circumstance, if the source files represented by the wildcard 
specification have incompatible attributes, unpredictable results can occur, 
depending on how the final destination file is to be used; an error message 
may or may not be generated. By using the /INQUIRY switch, the user can 
make a decision, on a file by file basis, as to whether or not a file should be 
included in the operation. 


4.5.11 /LIST— Output a Normal DIRECTORY Listing 


The /LIST switch can be used at the end of the DIRECTORY command to 
give a directory listing including device, directory, file name, file type, file 
size, protection code, and creation date and time. This listing is similar to 
the directory listing generated by the RSTS/E PIP program. 


DECnet/E Guide to User Utilities 


If no switch is appended to the DIRECTORY command, the /LIST switch is 
assumed. 


Example: 


NFT> DIRECT DENVER: :(100,57]*%.*/LIST 


4.5.12 /LOG-—Log Input File Name on Close 


The /LOG switch can be applied to the source file specification in the 
APPEND, COPY, SUBMIT, PRINT, TYPE, and DELETE commands. It is 
used to request that the name of each input file be logged to the console after 
the indicated function is performed. This is useful when the input file speci- 
fication contains wildcards. 


Example: 


NFT> COPY BOSTON: :(1+2301]*.*=DENVER: :(3+451]#.MAC/LOG 


4.5.13 /MORE or- —Continue Command to Next Line 


This switch can be used at the end of a terminal line to indicate that the 
command is to be continued on the next line. NFT then prompts for contin- 
uation lines with the characters “MORE>”. A CTRL/Z typed in a contin- 
uation line causes the whole command to be deleted and the “NFT>” prompt 
to be displayed. (Otherwise, a CTRL/Z terminates NFT and returns control 
to the RSTS/E monitor.) To continue a command to several lines, the 
switches can be used more than once. 


The /MORE switch or hyphen (-) cannot be used when NFT is run as a 
single-line command: 


NFT command 
Example: 
NET> DALLAS::DK0:(120,1531]F ILE. RNO=BOSTON: :£30 +205 1DK1/MORE 
MORE> :FILE.RNO>- 


MORE> FILE3.RNO 
NFT> 


4.5.14 /NATIVE — Reformat File to Stream ASCII 


This switch can be applied to the destination file specification in a COPY, 
APPEND, SUBMIT, or PRINT command when the destination node is a 
RSTS/E node. It may also be used in the TYPE command. It converts files 
stored at the source node (in either of two ASCII formats) to stream ASCII 
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files at the destination node. The two source formats are: (1) RMS-11 vari- 
able-length records with implied carriage control, or (2) variable-length 
records with imbedded carriage control characters. This is useful when 
transferring ASCII files from an RSX or VAX/VMS node, that does not proc- 
ess stream ASCII, to a RSTS/E node, that does. 


Example: 


NFT> COPY TEST.MAC/NA=DALLAS::FIL.MAC 


The /NATIVE switch can also be applied to the source file specification in a 
COPY, TYPE, APPEND, SUBMIT, or PRINT command when the source 
node is either a TOPS20 or an RT11 node and the files are to be transferred 
as stream ASCII files to the destination node. The /NATIVE switch is used 
to inform the source node that the file is stream ASCII, so that the source 
node sends it as such across the network. RT11 and TOPS820 files do not have 
file attributes recorded as part of the file, so NFT at the source has no way of 
knowing, without the /NATIVE switch, that the file is stream ASCIL 


Example: 


NFT> COPY PROGA.MAC=MIAMI::PROGA.MAC/NA 


NOTE 


The /NATIVE switch is incompatible with and should not 
be used with the /BLOCK switch, described in Section 4.5.3. 


4.5.15 /NOCONTIGUOUS - Allocate Space Noncontiguously 


This switch can be applied to the destination file specification in the COPY, 
SUBMIT, or PRINT command. It allocates noncontiguous space for the des- 
tination file(s). 


Example: 


NFT> COPY DALLAS: :FILE1.TSK/NOCO=MYFILE.TSK 


In this example, noncontiguous space is allocated at node DALLAS (an 
RSX-11M node) for the binary file FILE1.TSK, consisting of the file 
MYFILE.TSK transferred from the local node. 


4.5.16 /NODELETE — Save Temporary Files 


The /NODELETE switch can be applied to the destination file specification 
in a PRINT or SUBMIT command to suppress deletion of the temporary 
file(s) created at the destination node. 
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Example: 


NFET> SUBMIT BOSTON: :RBAT.CTL/NOD=*,.CTL 
NET® PRINT TEXT.DOC/NODELETE=DALLAS: :BOOK??.DOC 


4.5.17. /NOHEADING - Output a DIRECTORY Listing with No 
Header 


The /NOHEADING switch can be used at the end of the DIRECTORY com- 
mand to give a listing without the header line across the top. The directory 
listing includes a complete file specification for each entry: device, project- 
programmer number, file name and file type. This switch is useful in creat- 
ing batch command files. 


Example: 


NET? DIRECT LIBRY.CTL=DALLAS::(0251731%,S5AY/NOHEAD 


4.5.18 /NOSUPERSEDE — Do Not Supersede an Existing File 


This switch can be applied to the destination file specification in a COPY, 
SUBMIT, or PRINT command. If a file already exists at the destination node 
with the same name as that given in the command, the command will fail. 


Normally, when NFT finds that the specified output file name already 
exists, it prompts the user, asking whether the existing file should be super- 
seded. The /NOSUPERSEDE switch disables this automatic feature. This is 
useful in batch command files that cannot handle unexpected prompting for 
user input. 


Example: 


NFT> COPY FILE.LST/NOSU=BOSTON::FILE. TAT 


4.5.19 /POS- Position to End of Volume 


The /POS switch can be applied to the destination file specification in a 
COPY command when the device is magnetic tape. It positions the file to the 
current end of volume before the transfer. 


Example: 


NET> COPY MT2Z:HPFIL.BAC/POS=BOSTON: :HPRTN. BAC 
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4.5.20 /RWC— Rewind on Close 


The /RWC switch can be applied to any file name in a COPY command when 
the device is magnetic tape. It rewinds the tape after the file is closed (after 
the transfer). 


Example: 


NFT> COPY MTi:RMAX.BAS/RWC=BOSTON: :RMAX.BAS 


4.5.21 /RWO- Rewind on Open 


The /RWO switch can be applied to any file name in a COPY command when 
the device is magnetic tape. It rewinds the tape before the file is opened 
(before the transfer). 


Example: 


NFT?> COPY MTO:FILEX.RNO/RWO=BOSTON: : TEXT. RNO 


4.5.22 /SUPERSEDE — Supersede an Existing File 


This switch can be applied to the destination file specification in a COPY, 
SUBMIT, or PRINT command. If a file already exists at the destination node 
with the same name as that given in the command, the existing file will be 
replaced by the new file. 


Example: 


NFT?> COPY FILE.LST/SU=BOSTON: :FILE.TXT 


4.5.23 /TOTAL — Output Directory Size Only 


The /TOTAL switch can be used at the end of the DIRECTORY command to 
output the total size of the directory. Individual directory entries are not 
listed. 


Example: 


NFT> DIR MIAMI::Cis21*,*/TOTAL 


4.5.24 /VARIABLE — Reformat File to Variable Format 
This switch can be applied to the destination file specification in a COPY, 


APPEND, SUBMIT, or PRINT command. It converts a file from stream 
ASCH at the source node to RMS-11 variable-length record format with 
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implied carriage control. This switch is used mainly to transfer stream 
ASCII files from a DECnet/E or DECnet/RT node to an RSX or VAX/VMS 
node because RSX and VAX/VMS do not process stream ASCII files. 


Example: 


NFT? COPY DALLAS::FIL.MAC/VA=TEST.MAC 


This example copies a MACRO file from a DECnet/E node to the RSX node 
in the sample network. 


NOTE 


The /VARIABLE switch is incompatible with and should 
not be used with the /BLOCK switch, described in Section 
4.5.3. 


4.6 NFT Error Messages 


The error messages in this section are printed by NFT when you make some 
mistake in typing an NFT command (syntax errors) or when an error has 
occurred in initializing NFT. These errors are described in this section. 


Other error messages may appear for conditions diagnosed according to the 
Data Access Protocol (DAP) or by RMS (Record Management Services, used 
by NFT and FAL to do local I/O). These error messages are given in 
Appendix D. 
?NFT — Attempted continuation is illegal 
You cannot continue a one-line CCL command with the /MORE or - 
switch. 


?NFT — Break buffer overflow 
There are too many quotes, commas, underscores, and equal signs in the 
command. The current limit on these special characters per command is 
40. 

?NFT — File specification too long 
The file specification you typed is too long to fit in an internal buffer used 
by NFT. 

2NFT — GMCRS$ directive failure 


Tell your software specialist that the RSX-11M directive used to read 
the CCL command line has failed. Then retype the command, starting 
NFT with RUN $NFT. 
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?NFT — Invalid command format 
Can be caused by several errors: 


1. Trying to type something other than a node name in a NODESPECI- 
FICATION command. 

2. Typing “::” in a NODESPECIFICATION command without any node 
name, 

3. Using any switch other than /IDENTIFY of /INQUIRY in a DELETE 
or EXECUTE command. 

4. Not typing an equal sign (=) in an APPEND command. 

5. Typing an equal sign (=) in a DELETE, TYPE, or EXECUTE 
command. 

6. Typing anything but COMMANDS or SWITCHES after a HELP 
command. 

7. Not typing a node name in an EXECUTE command. 


?NFT — Invalid network node name 
Valid node names are 1 to 6 uppercase, alphanumeric characters and 
must contain at least one letter. 

?NFT — Invalid node name specification 
Either the node name is not in the right place or it contains non- 
alphanumeric characters. 

?NFT — More than one input node specification 
You cannot type more than one node name on the right side of an equal 
sign. 

?NFT — More than one output node specification 
You cannot type more than one node name on the left side of an equal 
sign. 

?NFT — No node name given for /IDENTIFY 
No node name was given for the IDENTIFY switch to operate on. 


?NFT — RMS initialization failure 


An error occurred in initializing RMS. If the error persists, call a soft- 
ware specialist. 


2NFT — Too many /IDENTIFY switches 


More than one /IDENTIFY switch was given on one side of an equal sign. 
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2NFT — Too many output file specifications 


More than one file name was given on the left side of an equal sign. 


?NFT — Too many = signs 


The command typed contains more than one equal sign. 


?NFT — Unmatched quote characters 


There are an odd number of quote characters in the command line. Quote 
characters must be paired. 


?NFT — Unrecognizable command 


Valid command keywords are described in Section 4.4. 


?NFT — Unrecognizable switch 


Valid switches are described in Section 4.5. 
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Chapter 5 
NETCPY: Network Copy between Devices 


The NETCPY utility allows you to copy all of the information on a DECtape, 
magtape, floppy disk, or disk from one DECnet/E node to a similar device on 
another DECnet/E node. One of the nodes must be the local node and both 
must be DECnet/E nodes. (NETCPY is a DECnet/E utility. There is no gen- 
eral DECnet utility to copy the contents of devices between nodes.) 


To protect devices from unauthorized use, a NETCPY user must supply log- 
in information for the remote node specified in the command. NETCPY will 
prompt for the information and check its validity before allowing the trans- 
fer to proceed. You can use the TLK utility (Chapter 2) to ask the operator at 
the remote DECnet/E system to mount tapes or do other preliminary prepa- 
ration of the physical devices. 


RUN $NETCPY 
>MTS3: = BOSTON:: MT2/FC 
REMOTE PPN 2120, 153 
REMOTE PASSWORD ? (not echoed) 
100 BLOCKS TRANSFERRED 
200 BLOCKS TRANSFERRED 
TIME TO COPY = 5.32117 MIN 
COPY COMPLETE 


BOSTON 
READY 


DENVER 


DALLAS 


MIAMI 


Figure 5-1 NETCPY Copies an Entire Device from One DECnet/E 
Node to Another DECnet/E Node 
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5.1 Running NETCPY 


You can run NETCPY from any terminal in a DECnet/E system by typing: 
RUN $NETCPY 


NETCPY responds with a message identifying itself and a pound-sign 
prompt (#). It will then accept one command. After you type the command, 
NETCPY will prompt for log-in information for the remote node, process the 
command, and terminate. Only one copy command can be given each time 


NETCPY is run. 
RUN $NETCPY 
NETCPY V2.0 RSTS V7.1 DECNET/E 
#command 
REMOTE PPN 2? ppn 


REMOTE PASSWORD ? password 
(NETCPY processes command, lists progress) 
Ready 


The ppn is the project-programmer number used to log in at the remote sys- 
tem — for example, 100,153. Likewise, the password is used to log in at the 
remote system. It is not echoed as you type it. 


The command is described in detail in the next section. 


5.2 General Form of NETCPY Command 
General Form of Command: 


[dstnode::|dstdevice:[dstsw] = [srcnode::|srcedevice: ae } [sresw] 
INC 


Parameter Descriptions: 
dstnode 


The dstnode is the destination node — the 1- to 6-character, uppercase, 
alphanumeric node name to which the contents of the device are to be cop- 
ied. The name must begin with at least one letter. If this node name is 
omitted, the local node is assumed. Either srcnode or dstnode MUST be the 
local node. Both must be DECnet/E nodes. 


dstdevice 


The dstdevice is the destination device. Allowable devices include the 
following: 


MTn: Magtape unit n 
DXn: Floppy disk unit n 
DKn: Disk unit n 

DTn: DECtape unit n 
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The destination device must be the same type as the device specified by 
srcdevice. NETCPY can be used to copy larger disks as well, but the speed of 
most transmission lines usually makes such operations impractical for 
remote transfers. 


dstsw 


Either or both of the optional switches /PA and /DE can be used, as described 
in Section 5.3. 


The equal sign separates the destination description from the source 
description. 


srcnode 


The srenode is the source node — the node from which the information is to 
be copied. If this name is omitted, the local node is assumed. Either dstnode 
or srcnode MUST be the local node. Both must be DECnet/E nodes. 


srcdevice 
The srcdevice is the source device. Allowable devices include the following: 


MTn: Magtape unit n 
DXn: Floppy disk unit n 
DKn: Disk unit n 

DTn: DECtape unit n 


The source device must be the same type as the device specified by dstdevice. 
IFC 

The /FC switch indicates that a fast copy is to be done. 

INC 


The /NC switch indicates no copy is to be done. It is used with the /VE switch 
for a verify-only run. 


srcsw 


Any or all of the optional switches /VERIFY, /BLOCK, /PARITY, and 
/DENSITY can be used, as described in Section 5.3. Switches can be abbre- 
viated to the first two characters of the keyword. 


Example: 
#BOSTON: :MTi:=MT2:/FC 


This command will cause the magtape device unit 2 at the local node to be 
copied to magtape device 1 at node BOSTON. The fast copy (/FC) switch is 
used to cause the copy. 


NETCPY: Network Copy between Devices 5-3 


5.3 NETCPY Option Switches 
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There are seven option switches that can be used with NETCPY. These are 
listed below and described in the following subsections. 


/BLOCK Specify Block size for magtape. 
/DENSITY Set the density for magtape. 


/FC Request a device copy. 
/HELP Obtain instructional information. 
/NC Request no device copy. 


/PARITY Set the parity for magtape. 
‘VERIFY Verify that the data is copied correctly. 


5.3.1 /BLOCK:b — Block Size Switch 


The /BLOCK switch, specifying block size, will allocate buffers for magtapes 
written with nonstandard record sizes. The default block size is 2048-byte 
blocks, which will handle most tapes and allows fast disk copies. Block (6) 
sizes must be in multiples of 512 bytes. The srcdevice is buffered at the speci- 
fied block size and the dstdevice is written (and/or verified) at the specified 
block size. 


Example: 


#MTO:=BOSTON: :MTi:/BL:4096/FC 


This command will cause magtape unit 1 at node BOSTON to be copied to 
magtape unit 0 at the local node in 4096-byte blocks, rather than the default 
of 2048-byte blocks. 


5.3.2 /DENSITY:d — Set Density Switch 


The /DENSITY switch can be used when copying magtapes to set the den- 
sity for either the source or destination device. The d parameter can be 
either 800 or 1600 bits per inch (BPI). 


Example: 
#MTO:/DENSITY:1G00/PARITY:EVEN=BOSTON: :MT1:/DENSITY:800/FC 
NETCPY reads a 9-track magtape on unit 1 at node BOSTON at 800 BPI 


and writes in 9-track format on magtape unit 0 at the local node at 1600 BPI 
with even parity (see Section 5.3.6). 


DECnet/E Guide to User Utilities 


5.3.3 /FC—Fast Copy Switch 


The /FC switch is used to request a device copy. Either /FC or /NC must be 
used after the srcdevice specification. If neither is used, NETCPY takes no 
action and prints an error message. 


NETCPY lists the progress of the copy in 100-block units for disk and in 
100-record units for tape. When the copy is complete, NETCPY lists the 
time it took and the total number of blocks or records transferred. 


Example: 


RUN $NETCPY 

NETCPY V2.0 RSTS VW?7.1 DECNET/E 
#BOSTON: :DTOs=DT2:/FC 

REMOTE PPN ? 1ls222 

REMOTE PASSWORD ? 


100 BLOCKS TRANSFERRED 
200 BLOCKS TRANSFERRED 
300 BLOCKS TRANSFERRED 
400 BLOCKS TRANSFERRED 
S00 BLOCKS TRANSFERRED 
TIME TO COPY = 5.11111 MIN 
COPY COMPLETE 
BLOCKS TRANSFERRED = 578 


Ready 


5.3.4 /HELP— Help Switch 


You can type /HE in response to the pound-sign prompt and get a help dis- 
play at the terminal. After the help information is displayed, another 
pound-sign prompt is given and you can then type a command. 


Example: 


RUN $NETCPY 
NETCPY ¥2,0 RSTS V7.1 DECNET/E 
#/HE 


’ 


(Help Display) 


#(command) 


5.3.5 /NC —No Copy Switch 
The /NC switch is used to request no copy. This switch is always used with 


the /VE (verify) switch for a verify-only run. Either /NC or /FC must be used 
after the srcdevice specification. The /NC switch has no effect by itself. 
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5.3.6 /PARITY:p — Set Parity Switch 


The /PARITY switch can be used when copying magtapes to set the parity 
for either the source or destination device. The p parameter can be either 
“ODD” or “EVEN”. The default is whatever was set by the system manager 
for that device at the node referenced. 


An example of the use of the /PARITY switch is given in Section 5.3.2. 


5.3.7 /VERIFY — Verify Switch 


This switch can be used with either the /FC or /NC switch to verify that the 
information on a device unit has been copied exactly. Verification is per- 
formed block by block and takes as much time as the copy operation. When 
used with /FC, the information is first copied from the source device to the 
destination device, and then sent back to be verified. When used with /NC, 
the information is simply verified. As the verification is performed, NET- 
CPY lists the progress. 


Example: 


RUN $NETCPY 
NETCPY V2.0 RSTS V7.1 DECNET/E 
#BOSTON: sDTO:s=DT2:/NC/VE 
REMOTE PPN ? laze 
REMOTE PASSWORD ? 
BEGINNING VERIFICATION PASS 
100 BLOCKS VERIFIED 
200 BLOCKS VERIFIED 
390 BLOCKS VERIFIED 
400 BLOCKS VERIFIED 
VERIFICATION COMPLETE © BAD BLOCKS 
OUT OF 492 BLOCKS VERIFIED 


Ready 


If the information has not been copied correctly, NETCPY prints the deci- 
mal number of blocks or records in which inconsistencies appear. The num- 
bers printed correspond to magtape record numbers and to disk and 
DECtape blocks of 512 bytes. 


Example: 


#DX1:=BOSTON: :DX2/FC/VE 
REMOTE PPN 7? 102,50 
REMOTE PASSWORD ? 

100 BLOCKS TRANSFERRED 


200 BLOCKS TRANSFERRED 
300 BLOCKS TRANSFERRED 
400 BLOCKS TRANSFERRED 


TIME TO COPY = 7.56667 MIN 
COPY COMPLETE 
BLOCKS TRANSFERRED #492 
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BEGINNING VERIFICATION PASS 
THE FOLLOWING BLOCKS ARE BAD 


i? 
31 
89 
iG0 BLOCKS VERIFIED 
200 BLOCKS VERIFIED 
300 BLOCKS VERIFIED 
400 BLOCKS VERIFIED 


VERIFICATION COMPLETE 3 BAD BLOCKS 
OUT OF 492 BLOCKS VERIFIED 


Ready 


5.4 NETCPY Error Messages 


Cannot specify both /FC and /NC 
Either fast copy (/FC) or no copy (/NC) option must be specified, but not 
both. 

Error in specifying density 
The density selected is not one of the valid values 200, 556, 800, DUMP, 
or 1600. 

Error in specifying parity 
The parity selected must be either ODD or EVEN. 


/FC or /NC must be specified 
Either fast copy (/FC) or no copy (/NC) must be specified. 


Illegal block size 
The block size selected with the /BL option must be a multiple of 512. 


Invalid node specification 
Hither the nodes specified did not include the local node, or NETCPY did 
not recognize the node name typed. 

Must have same type device 


Both the source device and the destination device must be magtape 
(MTn:), DECtape (DTn:), floppy disk (DXn:), or disk (DKn:). 
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(NSP command) — ABORT 


NETCPY sets up a logical link to the remote node to effect the transfer 
requested. If any network error occurs during execution of NETCPY, the 
program is aborted and this message is printed. The NSP command 
printed is the one NETCPY was trying to execute when the error 
occurred. For example, if NETCPY was trying to receive a message from 
the remote node, the message RECEIVE NETWORK ERROR - PRO- 
GRAM ABORT is printed. 


Type /HE for help 


NETCPY does not recognize the command typed. Use the /HE switch for 
help. 
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Chapter 6 
NETOFF: Network Shutdown 


The NETOFF utility lets you shut down your network in an orderly fashion 
without shutting down the entire RSTS/E operating system. It causes a 
gradual shutdown rather than an immediate disconnect. 


NETOFF performs a similar operation to the NCP SET EXECUTOR 
STATE SHUT command (see DECnet/E System Manager’s Guide). Both per- 
mit existing logical links to complete before ending network operations, but 
only NETOFF warns users that the network will close down in some deter- 
mined period of time. This gives network users an opportunity to respond to 
the warning message by finishing up network processing or by requesting 
that network operations be extended. 


To invoke NETOFF, you type: 
RUN $NETOFF 


NETOFF responds by asking how many minutes it should wait before new 
network links are prohibited (that is, until it effects a SET EXECUTOR 
STATE SHUT command) and how many minutes it should wait until actual 
network shutdown. 


After this, the following sequence of operations occurs: 
1. NETOFF broadcasts a message to all system terminal users: 
THE NETWORK IS SHUTTING DOWN IN [variable] minutes 


2. NETOFF then suspends execution for the appropriate number of min- 
utes, as determined in the dialog. When it resumes execution, it 
sends the SET EXECUTOR STATE SHUT message to NSP. If no log- 
ical links are open, NSP terminates network operations and the 
NETOFF program completes. Otherwise, NSP prohibits the forming 
of any new logical links, but allows normal operations to continue on 
existing links. 


3. NETOFF again suspends execution, this time for the remainder of 
the period before final network shutdown. When it resumes execu- 
tion, it sends the SET EXECUTOR STATE OFF message to NSP. 


4. At this point, NSP aborts any existing logical links and sends a Net- 
work Abort message to any local programs with links open. NSP then 
shuts down Transport, thus ending network operations. 


5. Finally, NETOFF sends a STOP command to the Event Logger pro- 
gram and displays the following message on the terminal: 


SHUTDOWN COMPLETE 
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You can interrupt this sequence at any point by typing CTRL/C. NETOFF 
resumes execution and sends the SET EXECUTOR STATE ON command to 
NSP, aborting the shutdown procedure and resuming normal network 
operations. 
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Appendix A 


Object Type Codes 


Code 


029-062 
063 

064-127 
128-255 


Type of Process 


General Task, User Process 

File Access (FAL/DAP Version 1) 
Unit Record Services (URD) 
Application Terminal Services (ATS) 
Command Terminal Services (CTS) 
RSX-—11M Task Control, Version 1 
Operator Services Interface 

Node Resource Manager 

IBM 3270-BSC Gateway 

IBM 2780-BSC Gateway 

IBM 3790-SDLC Gateway 

TPS Application 

RT-11 DIBOL Application 

TOPS-—20 Terminal Handler 
TOPS-—20 Remote Spooler 

RSX-11M Task Control, Version 2 
TLK Utility 

File Access (FAL/DAP Version 4 and later) 
RSX-11S Remote Task Loader 
Network Management Listener (NICE Process) 
RSTS/E Media Transfer Program (NETCPY) 
Reserved for DECnet use 

Mail Listener 

Host Terminal Handler (NPKDVR) 
Concentrator Terminal Handler 
Loopback Mirror 

Event Receiver 

VAX/VMS Personal Message Utility 
File Transfer Spooler (FTS) 
Reserved for DECnet use 

DECnet test tool (DTR) 

Reserved for DECnet use 

Reserved for customer extensions 
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Appendix B 


NSP Reason Codes for Connect Reject and Link Abort 


Reason 


No error — user-initiated reject or abort 

Resource allocation failure 

Destination node does not exist 

Node shutting down 

Destination program does not exist 

Invalid destination name or source field 

Destination program’s queue full 

Unspecified error condition 

Third party aborted logical link 

User-initiated link abort 

Reserved 

Invalid destination address in Connect Initiate Message 
Invalid desination address in Connect Confirm Message 
Source address zero in Connect Initiate or Connect Confirm Message 
Flow control violation — invalid request count in Link Service Message 
Reserved 

Too many connects to node 

Too many connects to destination program 

Access not permitted 

Logical link services mismatch 

Invalid accounting information 

Segment size too small 

User aborted, timed out, or canceled link 

No path to node 

Flow control failure — data received when request count zero 
No current link (cannot recognize destination address) 
Confirmation from remote system of Disconnect Message 
Image data field too long 
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NETACT: Automatic Log-in Utility for NFT 


The NETACT utility lets you define log-in entries for remote nodes so that 
you do not have to define them each time you run NFT. NETACT creates a 
file in your account (NETACT.DAT) that NFT uses to provide access control 
information whenever you reference a new remote node name in an NFT 
command. If the access control information specified in the file is sub- 
sequently rejected by the remote node, NFT will delete the entry from its 
internal data structures. It does not, however, delete the entry from 
NETACT.DAT. 


The NFT command NODESPECIFICATION and the /IDENTIFY switch 
takes precedence over the NETACT.DAT file in an NFT run. 


C.1 Howto Run NETACT 


You can run NETACT from any terminal in a DECnet/E system by typing: 
RUN $NETACT 


NETACT displays a message identifying itself and a prompt: NETACT>. It 
will then accept commands until you use the EXIT command to terminate 
NETACT. You can also type a CTRL/Z at any point during execution of 
NETACT. 


RUN $NETACT 
NETACT V2.0 RSTS V7.1 The ARK 
NETACT>command 


NETACT>’Z 
Ready 


C.2 NETACT Commands 


Six commands providing five functions are available with NETACT. These 
commands are listed below and described in the following subsections. Each 
command can be abbreviated to the first letter of the keyword. 


DEFINE Lets you define a log-in sequence for a remote node. 
EXIT Terminates NETACT. 

HELP or? _ Displays a line of helpful information at your terminal. 
LIST Displays the current definitions. 

PURGE Eliminates a log-in sequence for a remote node. 
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C.2.1 DEFINE Command 


The DEFINE command displays a series of questions. You respond to these 
questions to define a log-in sequence for a node. 


Example: 

NETACT ?DEFINE 

Node name ? DENVER 

Users <> ? 2/155 

Passwords <> ? MELBA 
- Accounts: ? ? ON4 


NETACT stores the entries in the file accessed by NFT. Thereafter, when 
the user types an NFT command referring to node DENVER, the project- 
programmer number (2,155), the password (MELBA), and account (3N4) 
will be used to gain access to node DENVER. 


Note that although the password is displayed as you type it, NETACT uses a 
simple two-way encryption to write it to the file NETACT.DAT. A malicious 
user cannot determine your passwords by displaying the file NETACT.DAT 
from your account. 


To redefine entries for a node, use the DEFINE command again. 


Example: 

NETACT?DEFINE 

Node name ? DENVER 
User: 4291553 ? 2,154 
Password: <MELBA> ° 
Account: 2S ON4> ? 


When you type a node name for which NETACT already has a definition, 
the current entries are displayed in angle brackets. You can change an 
entry by typing new values, as in the previous example. Depress the 
RETURN key to leave the entry unchanged. (Thus, the password MELBA is 
retained in the new entry created by the preceding example.) Depress the 
ESCAPE key to delete the entry entirely. (The account 3N4 is simply 
deleted in the preceding example; no new account is entered.) 


C.2.2 EXIT Command 


You can terminate NETACT by typing EXIT in response to the prompt. You 
can also terminate NETACT at any point by typing a CTRL/Z. If this is done 
while NETACT is waiting for response to a node name, user, password, or 
account prompt, the last command typed is not processed. 


Example: 


NETACT EMIT 


Ready 
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or 


NETACT?DEFINE 

Node name ? DALLAS 
Users <2+154> ? 2rill? 
Password: <MELBA? o 72 
Ready 


In the last example, the entire DEFINE command for node DALLAS is 
ignored; the original entries are retained. 


~C.2.3 HELP Command 


The HELP command displays information. It has two forms. 


NETACT HELP 


or 


NETACT?? 


C.2.4 LIST Command 


The LIST command displays current definitions. 


Example: 

NETACT3LIST 

Node BOSTON 
User 15117 

Password AGHAST 
Account 

Node DENVER 
User 2,154 

Password MELBA 

Account 


C.2.5 PURGE Command 
The PURGE command eliminates a current entry. 
Example: 


NETACT? PURGE 
Node name ? DALLAS 
Node DALLAS purged from file. 
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C.3. NETACT Error Messages 
Field too long 


You have entered too many characters. The following limits apply: 


Node name is limited to 6 characters. 
User is limited to 16 characters. 
Password is limited to 8 characters. 
Account is limited to 16 characters. 


lilegal command —command Type “Help” for help 
The command you just typed is not a valid NETACT command. Typing 
“HELP” will display the commands acceptable to NETACT. 

Invalid node name 


The nodename field cannot be null. 


Node nodename not defined. 


You are trying to purge a node definition that does not exist. Check the 
node name you typed for misspelling. Issue a LIST command to see cur- 
rent definitions. 
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Appendix D 
Error Messages Generated by RMS and DAP 


This appendix contains non-NFT error messages that can appear while 
using the Network File Transfer (NFT) program. These messages can 
appear for conditions diagnosed by the Record Management Services (RMS), 
used by NFT and FAL to do local input and output, or for violations of the 
Data Access Protocol (DAP), used to do remote file transfers across the 
network. 


D.1 NFT Error Messages from RMS—11 


NFT prints the following error message in response to detected RMS-11 
errors: 


?2NFT— RMS ERROR = nnnnnn 


The errors that can occur when you use NFT should be fairly under- 
standable, such as error 176440, “File not found.” However, all possible 
RMS errors are listed here, and some descriptions will be obscure to all but 
those familiar with RMS. If you get one of these errors repeatedly, call a 
software specialist and report the error. 


NOTE 


The following list reflects errors generated by RMS Version 
1.8 as described in the RMS-11 MACRO-II Reference 


Manual. 

Octal 

Value 

(nnnnnn) Description 

177760 Operation aborted: Stack save area exhausted or in-core data 
structures corrupted. 

177740 Files—11 ACP could not access the file. 

177720 File activity precludes action (e.g., attempting to close a file 
with outstanding asynchronous record operation). 

177700 Bad area identification number (AID) field in allocation XAB 
(i.e., out of sequence). 

177660 Invalid value in alignment boundary type (ALN) field of allo- 
cation XAB. 
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Octal 
Value 
(nnnnnn) 


177640 


177620 


177600 


177560 


177540 


177530 


177520 
177500 


177460 


177440 


177430 


177420 
177400 
177360 


177340 


177320 


177300 


Description 


Value in allocation quantity (ALQ) field in FAB (or allocation 
XAB) exceeds maximum or, during an explicit $EXTEND 
operation, equals zero. 


Records in a field on ANSI-labeled magnetic tape are variable 
length but not in ANSI-D format. 


Invalid value in allocation options (AOP) field in allocation 
XAB. 


Invalid operation at AST level: Attempting to issue a syn- 
chronous operation from an asynchronous record operation 
completion routine. 


Read error on file header attributes. 
Invalid file ID. 
Write error on file header attributes. 


Bucket size (BKS) field in FAB contains value exceeding 
maximum. 


Bucket size (BKZ) field in allocation XAB contains value 
exceeding maximum. 


Block length (BLN) field in a FAB, RAB, or XAB is incorrect. 


Beginning of file detected on $SPACE operation to magnetic 
tape file. 


Private buffer pool address not a double word boundary. 
Private buffer pool size not a multiple of 4. 


Internal error detected in RMS—11. No recovery possible; con- 
tact a software specialist. 


Cannot connect RAB (i.e., only one record access stream per- 
mitted for sequential files). 


$UPDATE attempting to change a key field that does not 
have the change attribute. 


Index file bucket check-byte mismatch. The bucket has been 
corrupted. Recovery can be attempted by: 


1. Moving disk pack to another device and trying the process 
again. 

2. Recreating file using either RMSIFL or RMSONV utility. 

3. Restoring file from last backup. 
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Octal 
Value 
(nnnnnn) 
177260 


177240 


177220 
177200 


177160 
177140 
177120 
177100 


177070 


177060 
177040 


177020 
177000 
176770 
176760 
176740 


176720 
176700 


176640 
176630 
177620 
176600 


Description 


$CLOSE function failed. 


Invalid OOD field in XAB or XAB type is invalid for the 
organization or operation. 


Files—11 ACP could not create file. 


No current record: Operation not immediately preceded by a 
successful $GET or $FIND. 


Files—11 ACP deaccess error during $CLOSE. 
Invalid area number in DAN field of key definition XAB. 
Record accessed by RFA access mode has been deleted. 


1. Syntax error in device name. 

2. No such device. 

3. Inappropriate device for operation (e.g., attempting to cre- 
ate an indexed file on magnetic tape). 


Files—11 ACP could not write bucket. RMS—11 deferred the 
I/O operation until it needed the I/O buffer for another bucket 
because the user program specified deferred writes. 


Syntax error in directory name. 


Dynamic memory exhausted: Insufficient space in central 
space pool or private buffer pool. 


Directory not found. 

Device not ready. 

Device positioning error. 

DTP field invalid (STV = @XAB). 


Duplicate key detected, “duplicates allowed” attribute not set 
for one or more key fields. 


Fiels—11 ACP enter function failed. 


Environment error: Operation or file organization not speci- 
fied in ORG$ macro. 


Expanded string area in NAM block too short. 
File expiration date not reached. 
File extend failure. 


Not a valid FAB: BID field does not contain FB$BID. 
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Octal 
Value 
(nnnnnn) 


176560 


176530 
176520 


176500 


176460 
176440 
176420 
176400 
176370. 


176360 
176340 
176320 


176300 


176260 


176240 
176220 


Description 


1. Record operation attempted was not declared in FAC field 
of FAB at open time. 

2. Invalid contents in FAC field. 

3. FB$PUT not present in FAC for $CREATE operation. 


Invalid file ID. 


Invalid combination of values in FLG field of key definition 
XAB (e.g., “no duplicates” and “changeable keys”). 


File locked by another user: Cannot access the file because 
sharing specification cannot be met. 


Files—11 ACP $FIND function failed. 
File not found during $OPEN. 
Syntax error in file name. 

Invalid file options. 


System error during FNA/DNA string parse (STV = system 
error code). 


Device full: Cannot create or extend file. 
Invalid area number in IAN field of key definition XAB. 


Index not initialized. This code can only occur in the STV field 
when STS contains ER$RNF. 


Invalid IFI field in FAB. 


Maximum number (254) of key definition or allocation XABs 
exceeded or multiple summary, protection, or date XABs pre- 
sent during operation. 


$INIT or $INITIF macro call never issued. 
Invalid operation. Examples include: 


1. Attempting a $TRUNCATE operation to a nonsequential 
file. 

2. Attempting an $ERASE or $EXTEND operation to a mag- 
netic tape file. 

3. Issuing a block mode operation (e.g., $READ or $WRITE) 
to a stream not connected for block operations. 

4. Issuing a record operation (e.g., $GET, $PUT) to a stream 
connected for block mode operations. 
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Octal 
Value 
(nnnnnn) 


176200 


176160 


176140 


176120 


176100 


176060 


176040 
176020 


176000 
175760 
175750 
175740 
175720 


175700 
175660 


175640 


Description 


Invalid record encountered in sequential file: Invalid count 
field. 


Invalid internal stream identifier (ISI) field in RAB (field may 
have been altered by user) or $CONNECT never issued for 
stream. 


Key buffer address (KBF) field equals 0. 


Record identifier (i.e., the 4-byte location addressed by KBF) 
for random operation to relative file is 0 or negative. 


Invalid key of reference (KRF) in RAB: 


1. During random $GET or $FIND operation, or 

2. During $CONNECT or $REWIND. In this case, ERSKRF 
is returned for the first record operation following the 
$CONNECT or $REWIND. 


Key size equals zero or too large (indexed file) or not equal to 4 
(relative file). : 


Invalid area number in LAN field of key definition XAB. 


Magnetic tape is not labeled in accordance with ANSI 
standards. 


Logical channel busy. 

Invalid value in logical channel number (LCH) field of FAB. 
Attempt to extend an area containing an unused extent. 
Invalid value in LOC field of allocation XAB. 


In-core data structures (e.g., I/O buffers) corrupted. This code 
can only occur in the STV field when STS contains ER$ABO. 


Files—11 ACP could not mark file for deletion. 


1. Maximum record number field contains a negative value 
during $CREATE of relative file. 

2. Record identifier (pointed to by KBF) for random operation 
to relative file exceeds maximum record number specified 
when file created. 


Maximum record size (MRS) field contains 0 during $CRE- 
ATE operation and: 


1. Record format is fixed, or 
2. File organization is relative. 
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Octal 
Value 
(nnnnnn) 


175620 


175600 


175560 


175540 


175520 
175500 


175460 
175440 


175420 


175400 


175360 


175340 
175320 


175300 


Description 


Odd address in Name Block address (NAM) field in FAB on 
$OPEN, $CREATE, or $ERASE. 


Not at end-of-file: Attempting a $PUT operation to a sequen- 
tial file when stream is not positioned to EOF. 


Cannot allocate internal index descriptor: Insufficient room 
in space pool while attempting to open an indexed file. 


No primary key definition XAB present during $CREATE of 
indexed file. 


$OPEN function failed. 
XABs in chain not incorrect order. 


1. Allocation or key definition XABs not in ascending (or den- 
sely ascending) order. 

2. XAB of another type intervenes in key definition or alloca- 
tion XAB sub-chain. 


Invalid value in file organization (ORG) field of FAB. 


Error in file’s prologue: File is corrupted; recovery can be 
attempted by: 


1. Moving disk pack to another device. 

2. Recreating file using either the RMSIFL or RMSONV 
utility. 

3. Restoring file from latest backup. 


Key position (POS) field in key definition XAB contains a 
value exceeding maximum record size. 


File header contains bad date and time information (retrieved 
by RMS-11 because a date and time XAB is present during an 
$OPEN or $DISPLAY operation). File may be corrupted. 


Privilege violation: Access to the file denied by the operating 
system. 


Not a valid RAB: BID field does not contain RB$BID. 


1. Invalid values in record access mode (RAC) field of RAB. 
2. Illogical value in RAC field (e.g., RBSKEY with a sequen- 
tial file). 


1. Invalid values in record attributes (RAT) field of FAB dur- 
ing $CREATE. 

2. Illogical combination of attributes (e.g., FB$CR and 
FB$FTN) in RAC field during $CREATE. 


(continued on next page) 
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Octal 
Value 
(nnnnnn) 


175260 


175240 


175220 


175200 


175160 


175140 


175120 
175100 


175060 
175040 


175020 
175000 


174760 


174740 


Description 


Record address (RBF) field in RAB contains an odd address 
(block mode access only). 


Files—11 ACP error: 


1. In record processing — read failure on file block. 
2. In block I/O —- VBN=0. 


Record already exists: During a $PUT operation in random 
mode to a relative file, an existing record found in the target 
record position. 


Invalid RFA in RFA field of RAB during RFA access. 


1. Invalid record format in RFM field of FAB during 
$CREATE. 
2. Specified record format is invalid for file organization. 


Target bucket locked by another task or another stream in 
the same program. 


Files—11 ACP $REMOVE function failed. 


Record identified by KBF/KSZ fields of RAB for random $GET 
or $FIND operation does not exist in relative or indexed file 
(for indexed files only, STV may contain ER$IDX). Record 
may never have been written or may have been deleted. 


$FREE operation issued but no bucket was locked by stream. 


Record options (ROP) field contains invalid values or illogical 
combination of values. 


Error while reading prologue. 


Invalid RRV record encountered in indexed file. File may be 
corrupted. 


Record stream active: In asynchronous environment, 
attempting to issue a record operation to a stream that has a 
request outstanding. 


Record size specified in RSZ of RAB during $PUT or 
$UPDATE is invalid: 


1. RSZ equals zero. 

2. RSZ exceeds maximum record size (MRS) specified when 
file created. 

3. RSZ not equal to size of Current Record for $UPDATE 
operation to a sequential file on disk. 
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Octal 
Value 
(nnnnnn) 


174720 


174710 


174700 


174660 


174640 


174620 


174600 


174560 
174540 


174520 


174500 


174440 


174430 
174420 
174410 


Description 


4. RSZ does not equal MRS (for fixed format records). 
5. RSZ not large enough to contain Primary Key of indexed 
file. 


Record too big for user’s buffer: RMS-11 could not move 
entire record retrieved by $GET operation to user work area 
(UBF/USZ). Note that this error does not destroy the current 
context of the stream. Rather, the stream’s context is updated 
as if the operation had been completely successful and as 
much of the record as possible is moved to user buffer. 


RRV update error on insert. 


During $PUT operation, key of record to be written is not 
equal to or greater than key of previous record (and RAC field 
contains RB$SEQ). 


Illogical value in SHR field of FAB (e.g., FB$WRI specified for 
sequential file). 


Invalid SIZ field in key definition XAB during $CREATE 
(e.g., specified size exceeds maximum record size). 


During asynchronous record operation, RMS—11 has found 
that the stack is too big to be saved. This code can only occur 
in the STV field when STS contains ER$ABO. 


System directive error. 
Index tree error: Indexed file is corrupted. 


Syntax error in file type (e.g., more than 3 characters 
specified. 


Invalid address in user buffer (UBF) field of RAB: 


1. UBF contains 0, or 
2. UBF not word aligned (for block mode access only). 


Invalid user buffer size (USZ) field in RAB (i.e., USZ contains 
0). 


Invalid VOL field in allocation XAB (i.e., VOL does not con- 
tain 0). 


Wildcard encountered during FNA/DNA string parse. 
File write error. 


Device is write locked. 
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Octal 
Value 
(nnnnnn) Description 


174400 Error while writing prologue. 

174360 XAB field in FAB (or NXT field in XAB) contains an odd 
address. 

174340 Extraneous field detected during FNA/DNA string parse. 


D.2 NFT Error Messages from DAP 


NFT prints the following error message in response to an error in NFT/FAL 


communication, violating the Data Access Protocol: 


INFT — DAP ERROR = aannnn 


The aa value gives the macro or functional group reason for the error. The 


nnnn value gives the micro, or specific, reason for the error. 


Possible values for the macro (aa) field are listed below. 


This list reflects the errors generated as the result of a vio- 
lation of DAP Version 5.6, as described in the DECnet 
DIGITAL Network Architecture, “Data Access Protocol 
Functional Specification,” released in October, 1980. 


D.2.1. Macro (aa) Field Values 


0 Pending Operation in progress 

1 Successful Returns information that indicates success. 

2 Unsupported This implemation of DAP does not support the 
specified request. 

Reserved 

4 File Open Errors that occur before a file is successfully 
opened. 

5 Transfer Error Errors that occur after opening a file and 
before closing that file. 

6 Transfer Warning For operations on open files, indicates the 
operation completed, but not with complete 
success. 

7 Access Termination Errors associated with terminating access to a 
file. 
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10 Format 


11 = Invalid 


12 Syne 
13-15 
16-17 


Error in parsing a message. Format is not 
correct. 


Field of message is invalid. For example, bits 
that are meant to be mutually exclusive are 
set, an undefined bit is set, a field value is out 
of range, or an invalid string is in a field. 


DAP message received out of synchronization. 
Reserved. 


User-defined STATUS message MACCODE 
field. 


D.2.2 Micro (nnnn) Field Values 


Micro (nnnn) values for use with macro (aa) values of 2, 10, and 11 octal are 
listed below. These refer to the macro Unsupported, Format, and Invalid 


categories. 


NOTE 


Micro (nnnn) Format: Bits 6-11 specify the DAP message 
type number. Bits 0-5 specify the DAP message field 
number. 


Miscellaneous errors: 


00 00 
00 10 


Unspecified DAP message error (catch all) 
DAP message type field (TYPE) error 


CONFIGURATION message errors by field: 


01 00 


Unknown field ~ 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 


Buffer size field (BUFSIZ) 

Operating system type field (OSTYPE) 

File system type field (FILESYS) 

DAP version number field (VERNUM) 

ECO version number field (ECONUM) . 

USER protocol version number field (USRNUM) 
DEC software release number field (SOFTVER) 
User software release number field (USRSOFT) 


System capabilities field (SYSCAP) 
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ATTRIBUTES message errors by field: 


02 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Attributes menu field (ATTMENU) 
Data type field (DATATYPE) 

File organization field (ORG) 

Record format field (RFM) 

Record attributes field (RAT) 

Block size field (BLS) 

Maximum record size field (MRS) 
Allocation quantity field (ALQ) 
Bucket size field (BKS) 

Fixed control area size field (FSZ) 
Maximum record number field (MRN) 
Run-time system field (RUNSYS) 
Default extension quantity field (DEQ) 
File options field (FOP) 

Byte size field (BSZ) 

Device characteristics field (DEV) 
Spooling device characteristics field (SDC) 
Longest record length field (LRL) 
Highest virtual block allocated field (HBK) 
End of file block field (EBK) 

First free byte field (FFB) 

Starting LBN for contiguous file (SBN) 


ACCESS message errors by field: 


03 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN 256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Access function field (ACCFUNC) 
Access options field (ACCOPT) 
File specification field (FILESPEC) 
File access field (FAC) 

File sharing field (SHR) 
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03 
03 


25 
26 


Display attributes request field (DISPLAY) 
File password field (PASSWORD) 


CONTROL message errors by field: 


04 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Control function field (CTLFUNC) 

Control menu field (CTLMENU) 

Record access field (RAC) 

Key field (KEY) 

Key of reference field (KRF) 

Record options field (ROP) 

Hash code field (HSH) 

Display attributes request field (DISPLAY) 


CONTINUE TRANSFER message errors by field: 


05 


20 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Continue transfer function (CONFUN C) 


ACKNOWLEDGE message errors by field: 


06 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


ACCESS COMPLETE message errors by field: 


07 


07 
07 
07 
07 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 
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14 
15 


20 
21 
22 


Bit count field (BITCNT) 
System specific field (SYSPEC) 


Access complete function field (CMPFUNC) 
File options field (FOP) 
Checksum field (CHECK) 


DATA message errors by field: 


10 


10 
10 
10 
10 
10 
10 


10 
10 


00 


10 
11 
12 
13 
14 
15 


20 
21 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Record number field (RECNUM) 
File data field (FILEDATA) 


STATUS message errors by field: 


11 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Macro status code field (MACCODE) 
Micro status code field (MICCODE) 
Record file address field (RFA) 
Record number field (RECNUM) 
Secondary status field (STV) 


KEY DEFINITION message errors by field: 


12 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Key definition menu field (KEYMENU) 
Key option flags field (FLG) 

Data bucket fill quantity field (DFL) 
Index bucket fill quantity field (IFL) 

Key segment repeat count field (SEGCNT) 
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Key segment position field (POS) 
Key segment size field (SIZ) 

Key of reference field (REF) 

Key name field (KNM) 

Null key character field (NUL) 
Index area number field (IAN) 
Lowest level area number field (LAN) 
Data level area number field (DAN) 
Key data type field (DTP) 

Root VBN for this key field (RVB) 
Hash algorithm value field (HAL) 
First data bucket VBN field (DVB) 
Data bucket size field (DBS) 

Index bucket size field (IBS) 

Level of root bucket field (LVL) 
Total key size field (TKS) 
Minimum record size field (MRL) 


ALLOCATION message errors by field: 


13 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Allocation menu field (ALLMENU) 
Relative volume number field (VOL) 
Alignment options field (ALN) 
Allocation options field (AOP) 
Starting location field (LOC) 

Related file identification field (RFD 
Allocation quantity field (ALQ) 

Area identification field (AID) 

Bucket size field (BKZ) 

Default extension quantity field (DEQ) 


SUMMARY message errors by field: 


14 


14 
14 
14 
14 
14 
14 


14 
14 


00 


10 
11 
12 
13 
14 
15 


20 
21 


Unknown field. 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Summary menu field (SUMENU) 
Number of keys field (NOK) 


D—14 DECnet/E Guide to User Utilities 


14 
14 
14 


22 
23 
24 


Number of areas field (NOA) 
Number of record descriptors field (NOR) 
Prologue version number (PVN) 


DATE AND TIME message errors by field: 


15 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Date and time menu field (DATMENU) 
Creation date and time field (CDT) 
Last update date and time field (RDT) 
Deletion date and time field (EDT) 
Revision number field (RVN) 


PROTECTION message errors by field: 


16 


00 


Unknown field 


DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Protection menu field (PROTMENU) 
File owner field (QWNER) 

System protection field (PROTSYS) 
Owner protection field (PROTOWN) 
Group protection field (PROTGRP) 
World protection field (PROTWLD) 


NAME message errors by field: 


17 


00 


Unknown field 


DAP message flages field (FLAGS) 

Data stream identification field (STREAMID) 
Length field (LENGTH) 

Length extension field (LEN 256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 


Name type field (NAMETYPE) 
Name field (NAMESPEC) 


Error Messages Generated by RMS and DAP 


D-15 


ACC 
use) 


ESS CONTROL LIST message errors by field: (Reserved for future 
00 Unknown field 

10 DAP message flags field (FLAGS) 

11 Data stream indentification field (STREAMID) 

12 Length field (LENGTH) 

13 Length extension field (LEN256) 

14 Bit count field (BITCNT) 

15 System specific field (SYSPEC) 

20 Access control list repeat count field (ACLCNT) 

21 Access control list entry field (ACL) 


Micro (nnnn) values for use with macro (aa) values of 0, 1, 4, 5, 6, and 7 
octal, are listed below. 


0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 


0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 


0020 
0021 
0022 
0023 
0024 


0025 


0026 
0027 
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NOTE 


Micro (nnnn) Format: Bits 0-11 contains error code num- 
ber. Symbolic status codes, where supplied, refer to the cor- 
responding RMS status codes. They are included here for 
ease of reference only — they have no meaning for DAP. 


Unspecified error 
ER$ABC Operation aborted (STV = ER$STK/MAP) 
ER$ACC F11-ACP could not access file (STV = sys err code) 
ER$ACT File activity precludes operation 
ERS$AID Bad area ID 
ERSALN Alignment options error 
ER$ALQ Allocation quantity too large or equal to 0 
ER$ANI Not ANSI-D format 
ER$AOP Allocation options error 
ER$AST Invalid (i.e. synch) operation at AST level 
ER$ATR Attribute read error 
ERSATW Attribute write error 
ER$BKS Bucket size too large 
ER$BKZ Bucket size too large 
ER$BLN BLN length error 
ER$BOF Beginning of file detected 
ER$BPA Private pool address not multiple of 4 
ER$BPS Private pool size not multiple of 4 
ER$BUG Internal RMS error condition detected 
ER$CCR Cannot connect RAB _ 
‘ER$CHG $UPDATE changed a key without having attribute of 
XB$CHG set 
ER$CHK Bucket format check-byte failure 
ER$CLS RSTS/E close function failed 
ER$COD Invalid or unsupported COD field 
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0030 
0031 


0032 
0033 
0034 
0035 
0036 
0037 
0040 
0041 
0042 
0043 
0044 
0045 
0046 
0047 


0050 
0051 
0052 
0053 
0054 


0055 
0056 
0057 


0060 
0061 
0062 
0063 
0064 
0065 
0066 
0067 


0070 
0071 
0072 
0073 
0074 
0075 
0076 
0077 


0100 
0101 
0102 
0103 
0104 


ER$CRE 
ERSCUR 


ER$DAC 
ER$SDAN 
ER$DEL. 
ER$DEV 
ER$DIR 

ERSDME 
ER$SDNF 
ER$DNR 
ER$DPE 
ER$DTP 
ER$DUP 
ERSENT 
ERSENV 
ERSEOF 


ER$ESS 
ERSEXP 
ERSEXT 
ER$FAB 
ER$FAC 


ER$FEX 
ER$FID 
ER$FLG 


ER$FLK 
ER$FND 
ER$SFNF 
ER$FNM 
ER$FOP 
ER$FUL 
ER$IAN 
ERSIFI 


ER$IMX 
ERSINI 
ER$IOP 
ERS$IRC 
ERSISI 
ER$KBF 
ER$SKEY 
ER$KRF 


ER$KSZ 
ER$LAN 
ER$LBL 
ERSLBY 
ER$LCH 


F11-ACP could not create file (STV =sys err code) 
No current record (operation not preceded by $GET/ 
$FIND) 

F11-ACP deaccess error during close 

Date area number invalid 

RFA-Accessed record was deleted 

Bad device or inappropriate device type 

Error in directory name 

Dynamic memory exhausted 

Directory not found 

Device not ready 

Device has positioning error 

DTP field invalid 

Duplicate key detected, XB$DUP not set 
RSX-F11ACP enter function failed 

Operation not selected in ORG$ macro 

End of file 


Expanded string area too short 

File expiration date not yet reached 

File extend failure 

Not a valid FAB (BID field not = FB$BID) 

Invalid FAC for REC-OP: 0, or FB$PUT not set for 
$CREATE 

File already exists 

Invalid file ID 

Invalid flag-bits combination 


File is locked by other user 
RSX-F11ACP find function failed 
File not found 

Error in file name 

Invalid file options 

Device/file full 

Index area number invalid 
Invalid IFI value or unopened file 


Maximum NUM (254) areas/key XABS exceeded 
$INIT macro never issued 

Operation unknown or invalid for file organization 
Invalid record encountered (sequential files only) 
Invalid ISI value on unconnected RAB 

Bad key buffer address (KBF = 0) 

Invalid key field (KEY = 0 or negative) 

Invalid key-of-reference ($GET/$FIND) 


Key size too large (IDX/NOT = :(REL)) 
Lowest level index area number invalid 
Not ANSI labeled tape 

Logical channel busy 

Logical channel number too large 
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0105 
0106 
0107 


0110 
0111 
0112 


0113 


0114 
0115 
0116 
0117 


0120 
0121 
0122 
0123 
0124 
0125 
0126 
0127 


0130 
0131 


0132 
0133 
0134 
0135 
0136 
0137 


0140 
0141 
0142 
0143 
0144 
0145 
0146 


0147 
0150 


0151 
0152 
0153 
0154 
0155 
0156 


ERSLEX 
ER$LOC 
ERSMAP 


ER$MKD 
ER$MRN 
ERSMRS 


ER$NAM 


ER$SNEF 
ER$NID 

ER$NPK 
ER$SOPN 


ER$SORD 
ER$SORG 
ER$PLG 
ER$POS 
ER$PRM 
ER$PRV 
ER$RAB 
ER$RAC 


ER$RAT 
ER$RBF 


ER$RER 
ER$REX 
ER$RFA 
ER$RFM 
ER$RLK 
ER$RMV 


ER$RNF 
ER$RNL 
ER$ROP 
ER$RPL 
ER$RRV 
ER$RSA 
ER$RSZ 


ER$RTB 
ER$SEQ 


ER$SHR 
ER$SIZ 

ER$STK 
ER$SYS 
ER$TRE 
ER$TYP 


Logical extend error, prior extend still valid 
LOC field invalid 
Buffer mapping error 


F11ACP could not mark file for deletion 

MRN value = negative or relative key > MRN 

MRS value = 0 for fixed length records or 0 for relative 
files 

NAM block address invalid (NAM = 0 or not acces- 
sible) 

Not positioned to EOF (sequential files only) 

Cannot allocate internal index descriptor 

No primary key defined for indexed file 

RSTS/E open function failed 


XABs not in correct order 

Invalid file organization value 

Error in file’s prologue (reconstruct file) 

POS field invalid (POS>MRS, STV = XAB indicator) 
Bad file date field retrieved 

Privilege violation (OS denies access) 

Not a valid RAB (BID field not = RB$BID) 

Invalid RAC value 


Invalid record attributes 

Invalid record buffer address (odd, or not word-aligned 
if BLK-IO) 

File read error (STV = sys err code) 

Record already exists 

Bad RFA value (RFA =0) 

Invalid record format 

Tanget bucket locked by another stream 
RSX-F11ACP remove function failed 


Record not found 

Record not locked 

Invalid record options 

Error while reading prologue 

Invalid RRV record encountered 

RAB stream currently active 

Bad record size (RSZ>MRS, or not=MRS if fixed 
length records) 

Record too big for user’s buffer 

Primary key out of sequence (RAC =RB$SEQ for 
$PUT) 

SHR field invalid for file (cannot share sequential files) 
SIZ field invalid 

Stack too big for save area 

System directive error 

Index tree error 

Error in file type; extension on FNS too big 
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0157 


0160 
0161 
0162 
0163 
0164 
0165 
0166 
0167 


0170 
0171 
0172 
0173 
0174 
0175 
0176 
0177 


0200 
0201 
0202 
0203 
0204 
0205 
0206 
0207 


0210 
0211 
0212 
0213 


0214 
0215 
0216 
0217 


0220 
0221 
0222 
0223 
0224 
0225 
0226 
0227 


0230 
0231 
0232 


ERSUBF 


ER$USZ 

ER$VER 
ER$VOL 
ERSWER 
ERSWLK 
ER$WPL 
ER$XAB 
BUGDDI 


CAA 
CCF 
CDA 
CHN 
CNTRLO 
CNTRLY 
DNA 
DVI 


ESA 

FNA 

FSZ 

TAL 

KFF 

LNE 
NOD 
NORMAL 


CK_DUP 
CK_IDX 

CK_RLK 
CK_RRV 


CREATE 
PBF 
PNDING 
QUO 


RHB 
RLF 
RSS 
RST 
SQO 
SUC 
SPRSED 
SYN 


TMO 
ER$BLK 
ER$BSZ 


Invalid user buffer address (0, odd, or if BLK-IO not 
word-aligned) 


Invalid user buffer size (USZ=0) 

Error in version number 

Invalid volume number 

File write error (STV = sys err code) 

Device is write locked 

Error while writing prologue 

Not a valid XAB (@XAB = odd, STV = XAB indicator) 
Default directory invalid 


Cannot access argument list 

Cannot close file 

Cannot deliver AST 

Channel assignment failure (STV = sys err code) 
Terminal output ignored due to Control-O 
Terminal input aborted due to Control-Y 
Default file name string address error 

Invalid device ID field 


Expanded string address error 
File name string address error 
FSZ field invalid 

Invalid argument list 

Known file found 

Logical name error 

Node name error 

Operation successful 


Record inserted had duplicate key 

Index update error occurred; record inserted 

Record locked buy read anyway 

Record inserted in primary, buy may not be accessible 
by secondary keys or RFA 

File was created, but not opened 

Bad prompt buffer address 

Asynchronous operation pending completion 

Quoted string error 


Record header buffer invalid 

Invalid related file 

Invalid resultant string size 

Invalid resultant string address 
Operation not sequential 

Operation successful 

Created file superseded existing version 
File name syntax error 


Time-out period expired 
FB$BLK record attribute not supported 
Bad byte size 
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0233 ERS$CDR Canot disconnect RAB 

0234 ER$CGJ Cannot get JFN for file 

0235 ERSCOF Cannot open file 

0236 ERS$JFN Bad JFN value 

0237 ER$PEF Cannot position to end of file 

0240 ER$TRU Cannot truncate file 

0241 ERS$UDF File is currently in an undefined state; access is denied 
0242 ER$XCL File must be opened for exclusive access 


0243 Directory full 

0244 Handler not in system 

0245 Fatal hardware error 

0246 Attempt to write beyond EOF 

0247 Hardware option not present 

0250 Device not attached 

0251 Device already attached 

0252 Device not attachable 

0253 Sharable resource in use 

0254 Invalid overlay request 

0255 Block check or CRC error 

0256 Caller’s nodes exhausted 

0257 Index file full 

0260 File header full 

0261 Accessed for write 

0262 File header checksum failure 

0263 Attribute control list error 

0264 File already accessed on LUN 

0265 Bad tape format 

0266 Invalid operation on file descriptor block 
0267 2 different devices specified on a rename 
0270 New file name specified in rename already in use 
0271 Cannot rename old system 

0272 File already open 

0273 Parity error on device 

0274 End of volume detected 

0275 Data over-run 

0276 Bad block on device 

0277 End of tape detected 

0300 No buffer space for file 

0301 File exceeds allocated space; no blocks 
0302 Specified task not installed 

0303 Unlock error 

0304 No file accessed on LUN 

0305 Send/receive failure 

0306 SPL Spool or submit command file failure 
0307 NMF No more files 

0310 CRC DAP file transfer checksum error 
0311 Quota exceeded 
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0312 
0313 
0314 
0315 
0316 
0317 


0320 
0321 
0322 
0323 
0324 


0325 
0326 
0327 


0330 
0331 
0332 
0333 
0334 
0335 
0336 
0337 


0340 


0341 
0342 
0343 
0344 
0345 
0346 


0347 
0350 


0351 


0352 
0353 


0354 
0355 
0356 
0357 


0360 


BUGDAP 
CNTRLC 


SNE 
SPE 
UPI 
ACS 


TNS 


Internal network error condition detected 
Terminal input aborted due to Control-C 
Data bucket fill size > bucket size in XAB 
Invalid expanded string length 

Invalid bucket format 

Bucket size of LAN not = IAN in XAB 


Index not initialized 

Invalid file attributes (corrupt file header) 

Index bucket fill size > bucket size in XAB 

Key name buffer not readable or writeable in XAB 
Index bucket will not hold two keys for key of refer- 
ence 

Multi-buffer count invalid (negative value) 

Network operation failed at remote node 

Record is already locked 


Deleted record successfully accessed 

Retrieved record exceeds specified key value 

Key XAB not filled in 

Nonexistent record successfully accessed 
Unsupported prologue version 

Invalid key-of-reference in XAB 

Invalid resultant string length 

Error updating RRVs; some paths to data may be lost 


Data types other than string limited to one segment in 
XAB 

Reserved 

Operation not supported over network 

Error on write behind 

Invalid wildcard operation 

Working set full (cannot lock buffers in working set) 
Directory listing; error in reading volume-set name, 
directory name, or file name 

Directory listing; error in reading file attributes 


Directory listing; protection violation in trying to read 
the volume-set, directory or file name 

Directory listing; protection violation in trying to read 
file attributes 

Directory listing; file attributes do not exist 

Directory listing; unable to recover directory list after 
Continue Transfer (Skip) 

Sharing not enabled 

Sharing page count exceeded 

UPI bit not set when sharing with BRO set 

Error in access control string (poor man’s route 
through error) 


Terminator not seen 


Error Messages Generated by RMS and DAP —D-21 


0361 BES 
0362 PES 
0363 WCC 
0364 IDR 
0365 STR 
0366 FTM 
6000 to 7777 


Bad escape sequence 

Partial escape sequence 

Invalid wildcard context value 

Invalid directory rename operation 

User structure (FAB/RAB) became invalid during 
operation 

Network file transfer mode precludes operation 


User defined errors 


Micro (nnnn) values for use with macro (aa) value of 12 octal are listed 
below. This refers to the macro Synchronization category. 


0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0020 


NOTE 


Micro (nnnn) Format: Bits 0-11 contains message type 
number. 


Unknown 

Configuration 

Attributes 

Access 

Control 

Continue transfer 

Acknowledge 

Access complete 

Data 

Status 

Key definition attributes 
Allocation attributes extension 
Summary attributes extension 
Date and time attributes extension 
Protection attributes extension 
Name 

Access control list extended attributes 
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A 


Access control information, 
See Log-in information 
Account ID, 4-6, 4-20, C-2 
Active nodes, 2-2, 4-6 
Adjacent node, 1-2 
APPEND command (NFT), 4-9, 4-11 to 4-12 
/APPEND switch (NFT), 4-9, 4-29 
Appending files, 4-11, 4-29 
Automatic log-in, 
See NETACT 


BATCH, 

submitting files, 4-24 
Binary files, 4-29 
Block size on device transfer, 5-4 
/BLOCK switch (NETCPY), 5-4 
/BLOCK switch (NFT), 4-29 to 4-30 
Block transfer, 

verification, 5-6 
/BRIEF switch (NFT), 4-30 


Cc 


Carriage control, 4-34 
CCL command formats, 
NET, 3-2 
NFT, 4-4 
TLK, 2-2, 2-4 
Compatibility, 
Phase II, 1-5 
Concise Command Language, 
See CCL 
Contiguous files, 
allocation, 4-30 
/CONTIGUOUS switch (NFT), 4-80 
CONTINUE command (NET), 3-4 
COPY command (NFT), 4-13 to 4-14 
Copying devices, 5-1 
Copying files, 4-13 
Cost, 1-5 
CRC, 1-4 
/CTG switch (NFT), 4-30 
CTRL/P command (NET), 3-4 to 3-5 
Cyclic Redundancy Check, 
See CRC 


INDEX 


DAP, 1-4, 4-1, 4-8, 4-37 
version number, 4-27 
Data Access Protocol, 
See DAP 
DCL Run-Time System, 3-3, 4-4 
DDCMP, 1-4, 1-6 
DEFINE command (NETACT), C-2 
DELETE command (NFT), 4-15 
Deleting Files, 4-34 
/DENSITY switch (NETCPY), 5-4 
Devices, 
busy, 4-7 
copying, 5~1 
density, 5-4 
DMx controllers, 1-6 
magnetic tape, 4-7, 4-35 to 4-36, 5-4, 5-6 
parity, 5-6 
software drivers, 1-6 
specification (NETCPY), 5-2, 5-3 
specification (NFT), 4-7 
specification (TLK), 2-2, 2-3, 2-4 
verification of transfer, 5-6 
Dialog mode (TLK), 2-4 to 2-7 
Digital Data Communications Message Protocol, 
See DDCMP 
DIGITAL Network Architecture, 
See DNA 
DIRECTORY command (NFT), 4-16 to 4-17 
Directory listings (NFT), 4-30 to 4-32, 4-35, 4-36 
Directory names, 4-7 to 4-8, 4-20 
DMx controllers, 1-6 
DNA, 1-3 to 1-4 


Encryption of password, C-2 
End node, 1-4 
Error messages, 

DAP, D-9 to D-22 

NET, 3-9 

NETACT, C-4 

NETCPY, 5-7 to 5-8 

NFT, 4-37 to 4-39 

RMS, D-1 to D-9 

TLK, 2-7 to 2-10 
EXIT command (NET), 3-5 to 3-6 
EXIT command (NETACT), C-2 to C-3 
EXIT command (NFT), 4-18 


index 


FAL, 4-3 

Fast copy, 
NETCPY, 5-5 

/FC switch (NETCPY), 5-3, 5-5 

File Access Listener, 
See FAL 

Files, 
appending with NFT, 4-11, 4-29 
attributes, 4-9, 4-11, 4-29, 4-32, 4-33 to 4-34, 

4-36 to 4-37 

binary, 4-29 
block transfer, 4-29 to 4-30 
contiguous allocation, 4-30 
copying with NFT, 4-13 
deleting, 4-15, 4-34 
directory listings, 4-16 
image, 
See Binary files 
name and type, 4-8 
noncontiguous allocation, 4-34 
printing with NFT, 4-22 
specification (NFT), 4-7 to 4-8 
stream ASCTI, 4-33 to 4-34, 4-37 
submitting to BATCH, 4-24 
superseding existing, 4-35 to 4-36 
variable-length records, 4-34, 4-36 to 4-37 
virtual array data, 4-29 

/FULL switch (NFT), 4-31 


HELP command (NET), 3-7 
HELP command (NETACT), C-3 
HELP command (NFT), 4-19 
/HELP switch (NETCPY), 5-5 
Hop, 1-2 


AIDENTIFY switch (NFT), 4-4, 4-31 to 4-32, C-1 
Image files, 

See Binary files 
/INQUIRY switch (NFT), 4-9, 4-32 


Keyboard modes, 3-3 
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L 


Line input (NET), 3-7 to 3-8 
Link, 
logical, 1-2, 1-4, 4-3 
physical, 1-2, 1-6 
LIST command (NETACT), C-3 
/LIST switch (NFT), 4-32 
Local node, 1-2 
/LOG switch (NFT), 4-33 
Log-in, 
automatic, 
See NETACT 
Log-in information, 
NETCPY, 5-1 
NFT, 4-4, 4-6 to 4-7, 4-20, 4-31, C-1 
Logical link, 1-2, 1-4, 4-3 
LSN, 2-1, 2-3, 2-5 


Magnetic tape, 4-7, 4-35 to 4-36, 5-4, 5-6 
/MORE switch (NFT), 4-33 
Multipoint lines, 1-6 


Named directories, 4-7 to 4-8, 4-20 
/NATIVE switch (NFT), 4-33 to 4-34 
/NC switch (NETCPY), 5-3, 5-5 
NCP, 1-5 to 1-6, 4-6 
NET (Network Command Terminal Utility), 1-4, 
1-6, 3-1 to 3-9 
capabilities, 3-1 
CCL command format, 3-2 
commands, 3~3 to 3-9 
error messages, 3-9 
line input, 3-7 to 3-8 
node specification, 3-2 
running, 3-2 to 3-3 
single-character input, 3-7 to 3-8 
NETACT (Automatic Log-in Utility), 4-4, C-1 to 
C-4 
commands, C-2 to C-3 
error messages, C-4 
running, C-1 
NETCPY (Network Copy between Devices), 1-4, 1-6, 
5-1 to 5-8 
allowable devices, 5-2, 5-3 
capabilities, 5-2 
command format, 5-2 
device specification, 5-2 to 5-3 
error messages, 5-7 to 5-8 
log-in information, 5-1 
node specification, 5-2 to 5-3 
running, 5-2 
switches, 5-4 to 5-6 
verifying transfer, 5-6 


NETOFF (Network Shutdown), 6-1 to 6-2 
Network Command Terminal Utility, 
See NET 
Network Control Program, 
See NCP 
Network copy between devices, 
See NETCPY 
Network diameter, 1-2 
Network File Transfer, 
See NFT 
Network Services Protocol, 
See NSP 
Network shutdown, 
See NETOFF 
NFT (Network File Transfer Utility), 1-4, 1-6, 
4-1 to 4-39 
appending files, 4-11 to 4-12, 4-29 
capabilities, 4-1 
CCL command format, 4-4 
command format, 4-5 to 4-9 
commands, 4-10 to 4-27 
continuing command line, 4-33 
copying files, 4-13 
deleting files, 4-15, 4-34 
device specification, 4-7 
directory listings, 4-16, 4-30 to 4-31, 4-82, 
4-35 to 4-36 
error messages, 4-37 to 4-39 
error messages from DAP, D-9 to D-22 
error messages from RMS, D-1 to D-9 
file specification, 4-7 to 4-8 
log-in information, 4~4, 4-6 to 4-7, 4-20, 4-31, C-1 
node specification, 4-5 to 4-6 
printing files, 4-22 
quoted strings, 4-9 
running, 4-4 to 4-5 
switches, 4-28 to 4-37 
wildcards, 4-8 to 4-9 
/NOCONTIGUOUS switch (NFT), 4-34 
Node, 1-2 
active, 2-2, 4-6 
adjacent, 1-2 
end, 1-5 
local, 1-2 
nonrouting, 1-5 
’ Phase II, 1-5 
remote, 1-2 
routing, 1-5 
specification (NET), 3-2 
specification (NETCPY), 5-2 to 5-3 
specification (NFT), 4-5 to 4-6 
specification (TLK), 2-2, 2-3, 2-4 
/NODELETE switch (NFT), 4-34 
NODESPECIFICATION command (NFT), 4-4, 4-20 
to 4-21, C-1 
/NOHEADING switch (NFT), 4-35 
Noncontiguous files, 
allocation, 4-34 
Nonrouting node, 1-5 


NORMAL command (NET), 3-7 to 3-8 
/NOSUPERSEDE switch (NFT), 4-35 
NPKDVR, 3-1 to 3-2, 3-5 
NSP, 1-4 to 1-5 

reason codes, B-1 


Object type codes, A-1 
Octal Debugging Tool, 

See ODT 
ODT (Octal Debugging Tool), 3-8 
ODT command (NET), 3-8 to 3-9 
One-line mode (TLK), 2-2 to 2-4 
Operator Services Program, 

See OPSER 
OPSER, 2-3, 2-6 


P 


/PARITY switch (NETCPY), 5-6 
Password, 4-6, 4-20, 5-2, C-23 
encryption, C-2 
Patch, 
routing, 1-2 
length, 1-2 
Peripheral Interchange Program, 
See PIP 
Phase IT node, 1-5 
Physical link, 1-2, 1-6 
PIP, 4-30 to 4-32 
Point-to-point lines, 1-6 
/POS switch (NFT), 4-35 
PPN, 4-6, 4-8, 4-20, 5-2, C-2 
wildcarding, 4-8 
PRINT command (NFT), 4-22 to 4-23 
Printing files with NFT, 4-22 
Project-programmer number, 
See PPN 
Protocols, 1-4 
DAP, 1-4, 4-3 
DDCMP, 1-4, 1-6 
NSP, 1-4 to 1-5 
TRN, 1-4, 1-6 
Pseudo-keyboard driver, 
See NPKDVR 
PURGE command (NETACT), C-3 


Quote characters, 
NFT, 4-9 
Quoted strings (NFT), 4-9 


Index 


R capabilities, 2-1 
CCL command format, 2-2, 2-4 


Reason Codes (NSP), device specification, 2-2 to 2-4 
for Connect Reject and Link Abort, B-1 dialog mode, 2-4 to 2-7 
Record Management Services, error messages, 2-7 to 2-10 
See RMS node specification, 2-2 to 2-4 
Remote node, 1-2 one-line mode, 2-2 to 2-4 
RMS, 4-3, 4-34, 4-36 to 4-37 terminal listener (LSN), 2-1, 2-8, 2-5 
Routing, 1-2, 1-5 /TOTAL switch (NFT), 4-36 
cost, 1-5 Transport Protocol, 
hop, 1-2 See TRN 
network diameter, 1-2 TRN, 1-4, 1-6 
path, 1-2 TYPE command (NFT), 4-26 


path length, 1-2 
Routing node, 1-5 
/RWC switch (NFT), 4-36 
/RWO switch (NFT), 4-36 U 


UIC, 
Ss See PPN 
User Identification Code, 
SHOW ACTIVE NODES, 4-6 See PPN 
Single-character input (NET), 3-7 to 3-8 
Spooler, 
submitting to remote, 4-22 
Stream ASCII, 4-33 to 4-34, 4-37 Vv 
Strings, 
quoted (NFT), 4-9 /VARIABLE switch (NFT), 4-36 to 4-37 
SUBMIT command (NFT), 4-24 to 4-25 Variable-length aa rd 4-34, 4-36 
/SUPERSEDE switch (NFT), 4-36 /VERIFY switch (NETCPY) 5-6 
Superseding files, 4-385 to 4-36 VERSION command (NFT), 4-27 
Switches, Version number 
NETCPY, 5-4 to 5-6 DAP, 4-27 


NFT, 4-28 to 4-37 Virtual array data files, 4-29 


Virtual terminal, 


T See NET 
Terminal Communication Utility, 
See TLK 
Terminal Listener, WwW 
See LSN 
TLK (Terminal Communication Utility), 1-4, 1-6, Wildcards, 4-32 
2-1 to 2-10 NFT commands, 4-8 to 4-9 
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AA-H504B-TC 
READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 


company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


O ~—_ Assembly language programmer 
 ——-Higher-level language programmer 
Occasional programmer (experienced) 
[1 User with little programming experience 
1 Student programmer 
1 = Other (please specify) 
Name Date 
Organization 
Street 
City ee Stat Zip Code 


or 
Country 
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